> For the complete documentation index, see [llms.txt](https://docs.mazze.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mazze.io/run-a-node/feedback-and-reporting-issues.md).

# Feedback and reporting issues

Accurate reports are critical for node/miner/RPC stability.

## What to include in every report

* Environment: Docker or source build
* Config context: relevant `run/hydra.toml` fields (sanitize secrets)
* Exact command executed
* Full error output
* Time range of issue
* Node ID (if available)

## Required logs

### Docker

```bash
docker logs -f mazze-node
docker logs -f mazze-miner
```

### Source build

```bash
tail -n 300 logs/mazze-node.log
tail -n 300 logs/mazze-miner.log
```

## Useful diagnostic checks

```bash
./run/mazze-cli.sh status
./run/mazze-cli.sh summary
```

And RPC status call from [RPC Guide](https://docs.mazze.io/run-a-node/rpc.md).

## Where to report

Use the official Mazze support/community channels and include the full context above so issues can be reproduced quickly.
