What do I need? #

In order to run Zigbee2MQTT we need the following hardware:

Name Price Picture
A supported Zigbee adapter 5$ - 40$ ZZH
One or more supported Zigbee device(s) - Zigbee devices
A computer (e.g. a Raspberry Pi) to run the Zigbee2MQTT software - Raspberry Pi
Highly recommended: Male to female USB extension cable (why?) +-2$ USB extension cable

Supported Zigbee adapter #

Zigbee2MQTT supports a variety of Zigbee adapters, the full list can be found here. What adapter to chose depends on your requirements in terms of price, size, connection (USB vs GPIO) and network size. For most users the recommend adapters are the “zig-a-zig-ah! (zzh!)” adapter by Electrolama OR the “CC2652RB stick” by slaesh.

Previously the Texas Instruments CC2531 was the most recommended adapter. This adapter is not recommended anymore since it’s not very powerfull, doesn’t have good range and struggles with larger network (20+ devices). It also requires additional hardware to flash the firmware, see Flashing the CC2531.

Flashing the adapter #

Before your Zigbee adapter can be used with Zigbee2MQTT it needs to be flashed with a custom firmware. This process varies per adapter and is described on the Supported adapters page. If an adapter provides both a router and coordinator firmware, use the coordinator firmware.

What’s next? #

Running Zigbee2MQTT