---
name: Bug report
about: Something isn't working as expected
labels: bug
---

## What happened

A clear description of the bug.

## Expected behaviour

What you expected to happen.

## Steps to reproduce

1.
2.
3.

## Environment

- Beacon version / commit:
- Go version:
- PostgreSQL version:
- OS:
- Deployment method (Docker / bare metal):

## Relevant logs or output

```
paste logs here
```

## Additional context

Any other context — config snippets (redact credentials), MQTT broker details,
mesh topology, etc.
