Troubleshooting category
Smart Home
Zigbee2MQTT pairing checks for coordinator, permit-join, device reset, and MQTT state. Start with the guide below, then use the service page if the symptom needs a remote session.
Zigbee2MQTT Message Not Published: Fix MQTT Connection Failures
Troubleshoot Zigbee2MQTT when messages are not published to the MQTT broker, causing entities to stay unavailable. Step-by-step checks for USB coordinator and new device setup.
Zigbee2MQTT Router Not Joining: Why the Network Map Stays Empty
Troubleshoot a Zigbee2MQTT router that won't join when the network map shows no coordinator or routers. Step-by-step checks and a verification test.
Zigbee2MQTT USB Adapter Permission: Fix 'Coordinator Not Found' on Startup
Troubleshoot Zigbee2MQTT USB adapter permission errors that cause 'coordinator not found' on startup. Step-by-step checks and verification.
Zigbee2MQTT Network Map Empty: Why the Coordinator and Routers Are Missing
Troubleshoot an empty Zigbee2MQTT network map when the coordinator and routers do not appear. Check MQTT topics, adapter state, and map generation, then verify with a test.
Zigbee2MQTT MQTT Connection Failed: Diagnose Broker Publishing Before Pairing
Zigbee2MQTT cannot publish to the broker and entities stay unavailable. Check broker settings, credentials, and network reachability to restore MQTT publishing.
Zigbee2MQTT Device Offline After Restart: Why Entities Vanish and How to Bring Them Back
All entities become unavailable after a Zigbee2MQTT or broker restart. Learn how to diagnose and restore your device without guesswork.
Zigbee2MQTT Device Offline: Why a Newly Paired Device Stops Reporting State
A newly paired Zigbee device joins Zigbee2MQTT but stops reporting state shortly after. Check link quality, power, and interview completion to restore reliable reporting.
Zigbee2MQTT MQTT Connection Fails: Diagnose Broker Publishing
Troubleshoot Zigbee2MQTT when MQTT connection fails and entities stay unavailable. Check broker settings, credentials, and network, then verify with a test publish.
Zigbee2MQTT Coordinator Not Found: Diagnose the USB Adapter Before Pairing
Zigbee2MQTT cannot open your USB coordinator on startup. Follow these checks to confirm the device path, permissions, and port state before pairing a new Zigbee device.
Zigbee2MQTT Device Pairs but Stops Responding: Fix the Silent Drop-Off
A device joins Zigbee2MQTT then stops reporting state. Follow these checks to confirm the cause and restore reliable reporting.
Zigbee2MQTT Permit Join: When the New Device Never Appears
Permit join runs but your new Zigbee device never appears in Zigbee2MQTT? Follow these checks to diagnose coordinator, network, and device-side issues.
Zigbee2MQTT Pairing Failed: What to Check When Permit Join Finds No Device
Troubleshoot a Zigbee2MQTT pairing failure when permit join runs but the new device never appears. Check coordinator status, channel, and device reset, then verify with a test.
Zigbee2MQTT Device Unavailable After Restart: Fix a Stale Pairing
A new Zigbee device goes unavailable after every Zigbee2MQTT or broker restart. Diagnose stale pairing state, verify with a controlled restart, and recover safely.
Zigbee2MQTT Message Not Published: When the Broker Connection Fails
Troubleshoot Zigbee2MQTT when messages are not published and the MQTT connection fails. Step-by-step checks for broker settings, credentials, and network access.
Zigbee2MQTT Router Not Joining: When the Network Map Stays Empty
Troubleshoot a Zigbee2MQTT router not joining when the network map shows no coordinator or routers. Step-by-step checks, interpretation, and verification.
Zigbee2MQTT Device Offline After a Service Restart: Restore Availability
All entities become unavailable after Zigbee2MQTT or the broker restarts. Follow these checks to diagnose and restore the device.
Zigbee2MQTT Device Offline After Pairing: Diagnose the Drop-Off
A practical fix for a Zigbee device that pairs but stops responding in Zigbee2MQTT. Learn exact checks, a verification test, and recovery steps.
Zigbee2MQTT MQTT Connection Failed: Fix Broker Publishing
Troubleshoot Zigbee2MQTT MQTT connection failed with a USB coordinator and new device. Check broker settings, credentials, and network, then verify with mosquitto_sub.
Zigbee2MQTT Network Map Empty: Why the Coordinator and Routers Don't Appear
Troubleshoot an empty Zigbee2MQTT network map when the coordinator and routers are missing. Check LQI, adapter state, and MQTT topics, then verify with a controlled test.
Zigbee2MQTT USB Adapter Permission: Fix Coordinator Not Found on Startup
Zigbee2MQTT cannot open your USB coordinator at startup? Fix zigbee2mqtt usb adapter permission issues with clear checks, a verification test, and a safe rollback.
Zigbee2MQTT Coordinator Not Found: Fix the USB Adapter Startup Error
Zigbee2MQTT cannot open your USB coordinator on startup? Follow these checks to confirm the port, permissions, and adapter path, then verify and recover safely.
Zigbee2MQTT Device Not Responding After Pairing: A Step-by-Step Fix
Device pairs but stops responding in Zigbee2MQTT? Follow these practical steps to diagnose and fix the issue with your USB coordinator and new Zigbee device.
Zigbee2MQTT MQTT Connection Fails: Fix Broker Publishing
Fix Zigbee2MQTT MQTT connection failures when the broker won't accept publishes. Step-by-step checks for broker address, credentials, and logs.
Zigbee2MQTT Pairing Failed: When Permit Join Never Finds a Device
Troubleshoot Zigbee2MQTT when permit join runs but a new device never appears. Check coordinator link, channel, and device reset, then verify with a controlled test.
Zigbee2MQTT Permit Join: Why Your New Device Never Appears
Permit join runs but your new Zigbee device never shows up in Zigbee2MQTT? Follow these checks to diagnose the coordinator, network, and device state.
Zigbee2MQTT Pairing Fails: Coordinator, Permit-Join, Device, Logs
A layered Zigbee2MQTT pairing test that ends with control and state after a restart.