Zigbee2MQTT

Active

Overview

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

PlanPriceIncludes
Community EditionFreeFull 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

AppDifference
ZHA (Zigbee Home Automation)Native Zigbee integration in Home Assistant without MQTT broker requirement.
deCONZUses ConBee/RaspBee sticks with REST API and supports more Zigbee profiles.
Tasmota (Zigbee version)Firmware for ESP32 with integrated Zigbee but requires hardware flashing.
Zigbee2TasmotaBridges 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)
  1. https://community.home-assistant.io/t/read-all-zigbee2mqtt-device-attributes-and-model-ids-via-template/908013
  2. https://www.zigbee2mqtt.io/guide/getting-started/
  3. https://www.zigbee2mqtt.io/guide/faq/
  4. https://www.zigbee2mqtt.io
  5. https://www.zigbee2mqtt.io/guide/configuration/
  6. https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/guide/usage/mqtt_topics_and_messages.md
  7. https://www.zigbee2mqtt.io/supported-devices/
  8. https://www.zigbee2mqtt.io/guide/installation/