Zigbee2MQTT

Zigbee2MQTT bridges Zigbee devices to MQTT, enabling integration with Home Assistant, Node-RED, and custom applications without proprietary hubs.

Architecture Overview

Zigbee Devices → [Adapter] → zigbee-herdsman → zigbee-herdsman-converters → zigbee2mqtt → MQTT Broker → Home Assistant/Apps

Three-layer stack:

• zigbee-herdsman: Hardware abstraction, Zigbee protocol handling
• zigbee-herdsman-converters: Device definitions, cluster-to-MQTT mapping
• zigbee2mqtt: Bridge application, state management, web UI

Configuration

Configuration lives in data/configuration.yaml. Key sections: