Zigbee2MQTT may sometimes stop working with Home Assistant, preventing Zigbee devices from showing or responding.
This can happen due to MQTT issues, wrong adapter settings, ZHA conflicts, outdated add-ons, or coordinator problems.
Fortunately, you can fix this with simple troubleshooting steps.
These include restarting Zigbee2MQTT, checking the MQTT broker, checking the adapter path, disabling ZHA, or updating the add-on.
In this guide, you will learn why Zigbee2MQTT is not working with Home Assistant, how to fix it step by step, and additional troubleshooting tips if basic solutions don’t work.
How To Fix Zigbee2MQTT Not Working With Home Assistant
1. Restart Zigbee2MQTT
A simple restart can often fix temporary Zigbee2MQTT problems.
Open Home Assistant.
Go to Settings.
Select Add-ons.
Open Zigbee2MQTT.
Click Restart.
Wait for the add-on to start again.
Check if your Zigbee devices are working now.
2. Restart the MQTT Broker
Zigbee2MQTT needs an MQTT broker to communicate with Home Assistant.
Open Home Assistant.
Go to Settings > Add-ons.
Open Mosquitto broker or your MQTT broker.
Click Restart.
Wait for it to start again.
Restart Zigbee2MQTT after restarting the broker.
3. Check the Zigbee Coordinator
If the coordinator is not detected, Zigbee2MQTT will not work.
Check if the Zigbee dongle is connected.
Unplug the dongle and plug it back in.
Use a USB extension cable if possible.
Avoid plugging it near USB 3.0 ports.
Restart Zigbee2MQTT and check the logs.
4. Check the Adapter Path
A wrong adapter path can stop Zigbee2MQTT from starting.
Open the Zigbee2MQTT add-on.
Go to Configuration.
Check the serial port or adapter path.
Use the correct device path for your dongle.
Save the settings.
Restart Zigbee2MQTT.
5. Disable ZHA If It Is Using the Same Dongle
ZHA and Zigbee2MQTT cannot use the same Zigbee coordinator at the same time.
Open Home Assistant.
Go to Settings > Devices & Services.
Check if ZHA is enabled.
Disable ZHA if you want to use Zigbee2MQTT.
Restart Zigbee2MQTT.
Check if the add-on starts properly.
6. Check Zigbee2MQTT Logs
The logs can show what is causing the problem.
Open Home Assistant.
Go to Settings > Add-ons.
Open Zigbee2MQTT.
Click Logs.
Look for errors about MQTT, adapter, or serial port.
Fix the error shown in the logs.
7. Update Zigbee2MQTT
An outdated add-on may cause bugs or connection issues.
Open Home Assistant.
Go to Settings > Add-ons.
Open Zigbee2MQTT.
Check if an update is available.
Click Update.
Restart the add-on after updating.
8. Reboot Home Assistant
If nothing else works, rebooting the system can help.
Open Home Assistant.
Go to Settings.
Select System.
Click Restart Home Assistant.
Wait for the system to come back online.
Check Zigbee2MQTT again.
Conclusion
Zigbee2MQTT not working with Home Assistant can be caused by MQTT problems, wrong adapter settings, ZHA conflicts, or coordinator issues.
You can usually fix it by restarting Zigbee2MQTT, checking the MQTT broker, checking the adapter path, or disabling ZHA if it is using the same dongle.
Following these steps should help you get Zigbee2MQTT working again.
Additional Reading
How To Fix Home Assistant Zigbee Devices Unavailable
How To Add A Zigbee Device To Home Assistant
How To Fix ESP32-C6 Zigbee Not Working With Home Assistant
Brianna is based in Minnesota in the US at the moment, and has been writing since 2017. She is currently a 3rd Year med student at the time of writing this.
