Zigbee2MQTT is an open-source bridge software that integrates hundreds of Zigbee devices with MQTT networks, removing the need for proprietary vendor hubs.
Zigbee2MQTT is a highly popular open-source software project that acts as a bridge between Zigbee wireless networks and MQTT-based home automation ecosystems. By using a compatible Zigbee USB dongle, users can run Zigbee2MQTT on a standalone server or within platforms like Home Assistant, effectively replacing proprietary vendor gateways.
It supports thousands of devices from hundreds of manufacturers, offering local, cloud-free control over smart sensors, lights, switches, and soil testers. Zigbee2MQTT provides a comprehensive network map, advanced device configuration, over-the-air (OTA) updates, and a rich Web UI for effortless smart home management.
Latest manuals from manuals+ curated for this brand.
Watch setup, installation, and troubleshooting videos for this brand.
Common questions about manuals, registration, and support for this brand.
Open the Zigbee2MQTT Web UI and click 'Permit join'. Then, put your Zigbee device into pairing mode (usually by holding the reset button for 3-5 seconds until the LED flashes). Once paired, the device will automatically appear in your dashboard.
You need a smart host (like a Raspberry Pi, NAS, or generic PC running Home Assistant) and a supported Zigbee 3.0 USB dongle (such as ones based on the EFR32MG21 or CC2652P chipsets) to act as the coordinator.
Navigate to Settings > Add-ons > Add-on Store. Add the official Zigbee2MQTT repository URL, install the add-on, configure your USB dongle's serial port path in the configuration tab, and start the service.