Z2M crashing without restarting
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
- Issue type
- Bug
- Clarity
- Needs clarification
- Activity status
- Active
- Tech stack
- docker, typescript
Research direction
Start by examining the shutdown log and the adapter disconnect handling; the report names Zigbee2MQTT 2.14.2, the zstack adapter, and a Sonoff Dongle-P, but gives no debug log or reproducible steps. Determine what causes the adapter to disconnect and the process to stop with restart=false; done means identifying a reproducible cause and a way to keep the service running or restart it.
Written by the indexing model from the issue text.
Description
What happened?
Hi,
For the last couple of releases, Z2M has been crashing every few days. It';s exhausting having to constantly check it is running.
The final lines in the log are:
[2026-11-12 13:49:56] info: zh:zstack:znp: closing
[2026-11-12 13:49:56] error: z2m: Adapter disconnected, stopping
[2026-11-12 13:49:56] info: z2m: Stopping Zigbee2MQTT (restart=false, code=2, signal=undefined)
[2026-11-12 13:49:56] info: z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/bridge/state', payload '{"state":"offline"}'
[2026-11-12 13:49:56] info: z2m: Disconnecting from MQTT server
[2026-11-12 13:49:56] info: z2m: Stopping zigbee-herdsman...
[2026-11-12 13:49:56] info: z2m: Stopped zigbee-herdsman
[2026-11-12 13:49:56] info: z2m: Stopped Zigbee2MQTT
To fix it I merely stop and restart the container:
docker compose down zigbee2mqtt
docker compose up -d
...I would mind as much if there was a way to automate Z2M restarting itself.
What did you expect to happen?
I expect Z2M to not stop or at least restart.
How to reproduce it (minimal and precise)
not a clue - it happens randomly every few days now.
Zigbee2MQTT version
2.14.2
Adapter firmware version
26.125.0
Adapter
Sonoff Dongle-P
Setup
Runs in docker on a Pi-5. I have been running Z2M stably for years until these recent releases.
Device database.db entry
No response
Debug log
No response
Notes
No response
- Dominant language
- TypeScript
- Stars
- 15.8k
- Forks
- 2.1k
- Avg merge
- 1d 6h
- Merged PRs (30d)
- 38
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Koenkk/zigbee2mqtt
-
[Feature request]: OTA for generated definitions of devices with an OTA client clusterPossibly taken @jabla claimed this 1 day ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 80/100
Koenkk/zigbee2mqtt#33684 · 1 comment ·
Maintainers usually reply within 1 day
-
new device support
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
Koenkk/zigbee2mqtt#33674 · 1 comment ·
Maintainers usually reply within 1 day
-
[Feature request]: Support espzb adapter (ESP Zigbee SDK v2, ESP32-S31)Possibly taken A pull request linked to this issue is open or already merged. Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
Koenkk/zigbee2mqtt#33668 ·
Maintainers usually reply within 1 day
-
problem
Difficulty 1/5 Under an hour Newbie friendliness 76/100
Koenkk/zigbee2mqtt#33645 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 83/100
Koenkk/zigbee2mqtt#33613 · 2 comments ·
Maintainers usually reply within 1 day
All issues in Koenkk/zigbee2mqtt
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
vercel-labs/ui#540 ·
Maintainers usually reply within 1 day
-
accepted ai-dev ai-implementing
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
livesport/homer#218 · 1 comment ·
Maintainers usually reply within 1 day
-
normalizePropName strips `#` characters from Figma property names instead of only the `#id` suffixOpen
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
figma/code-connect#419 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Negative values skip k/M abbreviation and medium decimal format on line, stacked-area, and tooltipOpen
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
britecharts/britecharts#1255 ·
Maintainers usually reply within 1 day