Zigbee2MQTT
What it is: A standalone service that runs a Zigbee coordinator and translates between Zigbee and MQTT. That lets Home Assistant, Node-RED or anything that speaks MQTT use it.1 It's an alternative to ZHA. The current version is 2.14.2 (10/2026).1
How it works
According to Z2M docs1:
- When pairing, Z2M "interviews" the device: what it is, which endpoints and clusters it has. Converters (Zigbee-Herdsman-Converters) then define per model what gets bound and how it maps to MQTT. Most devices use generic converters.
- A device sends a message, Z2M forwards it as an MQTT message, and the MQTT controller (HA, Node-RED) decides what happens.
- Frontend: a web UI for pairing, binding, groups and the network map.
Key features
- Pairing: permit join in the frontend opens for 254 s. You can pick a specific router for the device to join through.1
- Binding and groups: devices control each other directly (dimmer โ bulb or group), even when HA, Z2M or the coordinator is down. Z2M sets up reporting when binding.1
- Network configuration in
configuration.yaml:channel: ZLL channels 11, 15, 20 or 25 are recommended.pan_id,ext_pan_idnetwork_key:GENERATEcreates a random key.- Source: Z2M docs1
- Adapters: use a recommended adapter. CC2530 and CC2531 perform poorly.1
- Migration to ZHA works with the old adapter or from a Z2M backup (
coordinator_backup.json), see Zigbee coordinator migration.2
Gotchas
- Changing the
network_keyrequires re-pairing all devices. Changing the channel may require re-pairing some devices and only works withzstackandemberadapters.1 - ZHA is active in HA by default. When using Z2M, delete and ignore the discovered ZHA integration.2
- Support for Z2M comes from the Z2M community (forum, Discord), not Nabu Casa.2
- Z2M doesn't need much in the way of resources, but on weak hardware (e.g. a Raspberry Pi 3 together with HA) performance can suffer.1
Integrations
- Home Assistant via MQTT discovery, Node-RED via MQTT, ZHA (migration)
Related
Sources
- Zigbee2MQTT documentation (Zigbee network, stability, binding, pairing) โ โ Zigbee2MQTT documentation (network, binding, pairing, configuration, adapters).
- Home Assistant Connect ZBT-2 (Nabu Casa Support) โ โ ember adapter, migration to ZHA.
- SLZB-OS (SMLIGHT Manuals) โ โ network coordinator.
Intellihome