Zigbee2MQTT
ActiveOverview
Zigbee2MQTT is a software bridge that connects Zigbee devices to MQTT brokers, enabling integration with home automation systems. It requires a compatible Zigbee adapter (e.g., USB, GPIO, WiFi, or Ethernet), a host system like Raspberry Pi or Intel NUC, and an MQTT broker such as Mosquitto. Users include those building Zigbee networks for smart home control, supporting 5367 devices from 564 vendors via standard MQTT topics.472
Key Features
- Broad Device Support - Supports 5367 Zigbee devices from 564 vendors, with pairing and attribute handling.7
- MQTT Integration - Publishes Zigbee device states and accepts commands via configurable MQTT topics.46
- Multiple Adapter Compatibility - Works with various Zigbee coordinators like zStack, CC2531 via USB, GPIO, WiFi, or Ethernet.2
- Web Frontend - Provides an onboarding page at http://localhost:8080 for configuration and management.2
- YAML Configuration - Uses configuration.yaml in a writable data directory, with environment variable overrides.5
- Attribute Reporting - Sends Zigbee configure reporting commands for automatic state updates like temperature or battery.6
- Network Management - Limits devices per coordinator and supports routers, e.g., 55 devices with CC2531 setup.3
Pricing
| Plan | Price | Includes |
|---|---|---|
| Community Edition | Free | Full Zigbee2MQTT functionality, open-source under GitHub. |
Platforms & Requirements
Runs on Linux, Windows, and macOS via Node.js with low memory footprint, suitable for Raspberry Pi or Intel NUC. Requires a single dedicated Zigbee coordinator adapter not shared with other apps and an MQTT broker. No specific minimum requirements listed beyond writable data directory.283
Integrations & Ecosystem
- MQTT brokers (e.g., Mosquitto)
- Home Assistant (via MQTT)
- Node-RED
- openHAB
- ioBroker
- Domoticz
- Custom MQTT clients
Alternatives
| App | Difference |
|---|---|
| ZHA (Zigbee Home Automation) | Native Zigbee integration in Home Assistant without MQTT broker requirement. |
| deCONZ | Uses ConBee/RaspBee sticks with REST API and supports more Zigbee profiles. |
| Tasmota (Zigbee version) | Firmware for ESP32 with integrated Zigbee but requires hardware flashing. |
| Zigbee2Tasmota | Bridges Zigbee to Tasmota MQTT topics, less device support than Zigbee2MQTT. |
Reputation
Zigbee2MQTT is regarded as a reliable, mature open-source solution for Zigbee-MQTT bridging, praised for extensive device support and easy integration with platforms like Home Assistant. Community forums and Discord provide active support. Criticisms include device limits on certain adapters (e.g., 55 on CC2531) and lack of ZSE profile support.314
Sources (8)
- https://community.home-assistant.io/t/read-all-zigbee2mqtt-device-attributes-and-model-ids-via-template/908013
- https://www.zigbee2mqtt.io/guide/getting-started/
- https://www.zigbee2mqtt.io/guide/faq/
- https://www.zigbee2mqtt.io
- https://www.zigbee2mqtt.io/guide/configuration/
- https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/guide/usage/mqtt_topics_and_messages.md
- https://www.zigbee2mqtt.io/supported-devices/
- https://www.zigbee2mqtt.io/guide/installation/