To add a Zigbee sensor to Home Assistant, you need a compatible radio coordinator and one Zigbee stack: ZHA or Zigbee2MQTT. Start by choosing where the radio should sit in your home. Then match the coordinator’s exact model and firmware to the stack.
This guide was checked against the official Home Assistant, Zigbee2MQTT and manufacturer documentation on October 26, 2026. We did not test a physical coordinator or home network. Compatibility, range and firmware depend on the exact device and revision.
Key facts
- Each Zigbee network uses one coordinator. A radio already assigned to ZHA cannot also be used by Zigbee2MQTT.
- If you need both stacks, use separate coordinators and keep their networks separate. A Zigbee device belongs to one network at a time.
- USB works well when the Home Assistant host is near a suitable radio location. Wired Ethernet can place a supported serial-over-IP coordinator away from the host; the Zigbee devices still connect over radio.
- Check the exact model suffix, radio chip, stack, firmware and power requirements before flashing or buying an adapter.
Choose ZHA or Zigbee2MQTT
| ZHA | Zigbee2MQTT | |
|---|---|---|
| Runs as | Home Assistant integration | Separate application |
| MQTT broker | Not required | Required to connect to Home Assistant |
| Start here when | You want a built-in path and your coordinator and devices are supported | You need a device feature confirmed in its device page or already use MQTT |
| Check first | The ZHA compatible hardware and device information | The exact adapter, coordinator firmware and supported device page |
Do not choose by a generic device count. Check whether the exact model exposes the actions you need, such as a button’s single, double and long press. Home Assistant currently recommends Connect ZBT-2 for a new ZHA network; existing compatible adapters do not need replacing just because a newer model exists.
Choose USB, Ethernet or PoE
First choose a suitable radio location. A server in a metal cabinet may not be the best place for a coordinator, even if it is close to the router.
The server and coordinator can stay together
Start with a USB coordinator and an extension cable. Check the radio chip and firmware against the selected stack. If you use Docker, pass the device through to the container that runs ZHA or Zigbee2MQTT.
The server is in a cabinet, but the radio needs another location
Consider a coordinator with wired Ethernet. In Zigbee2MQTT, assign it a reserved IP address and TCP port. Ethernet carries the serial connection to the radio; Zigbee devices must still be within the home radio network.
The coordinator location has no convenient power outlet
Consider an Ethernet model with PoE only if the exact revision supports the required standard. For example, the SMLIGHT manual lists active 802.3af 48 V PoE for the SLZB-06 series. Check the exact suffix and the switch or injector specification before connecting it: Ethernet alone does not mean PoE is supported.
Prefer wired Ethernet for a remote serial adapter. Zigbee2MQTT warns that Wi-Fi serial bridges can lose packets or add latency; Home Assistant also discourages Wi-Fi, WAN or VPN serial connections for some radios. If wired Ethernet is unavailable, check the exact adapter and stack documentation before choosing a Wi-Fi bridge.
Match the exact adapter and firmware
Similar product names can hide different chips and configuration. The SONOFF ZBDongle-P uses Texas Instruments CC2652P and the Zigbee2MQTT zstack adapter. SONOFF ZBDongle-E V2 uses Silicon Labs EFR32MG21 and the ember adapter. Do not copy the P configuration to the E. Zigbee2MQTT currently lists EmberZNet NCP 7.4.x and newer; its E adapter notes recommend 7.4.4 or newer. ZBDongle-E uses software flow control, so do not enable rtscts for it.
The networked SMLIGHT SLZB-06 and SLZB-06M also use different radio chips: the manufacturer lists CC2652P for the 06 and EFR32MG21 for the 06M. Other suffixes use other chips and may have different recommended stacks. Read the table for the exact revision before selecting the adapter type or firmware.
For a USB adapter, a 50 cm extension can reduce interference from the computer. Keep the radio away from the computer case, USB 3.0 ports, a Wi-Fi router and an SSD. If the connection remains unreliable, try another port and orientation. Follow the device maker’s power instructions. On Linux, find the stable serial path with:
ls -l /dev/serial/by-id/
In Home Assistant Container, the host’s USB access does not automatically pass through to the container. Give the device only to the service that owns that coordinator. For a network adapter in Zigbee2MQTT, reserve its IP and set the TCP port shown in the adapter manual.
If you run both ZHA and Zigbee2MQTT
Use a separate radio for each application, with unique USB paths or network addresses. They form separate Zigbee networks. Devices do not belong to both networks at once; moving a device usually requires a factory reset and pairing again, following the device maker’s instructions. Check the radio channel in each stack and account for nearby Wi-Fi before forming or changing a network.
Do not buy a second coordinator just to improve coverage in one network. Add a compatible Zigbee router, such as a device documented as a router by the manufacturer, and check how the sensor behaves in the room. A second coordinator creates a separate network.
Frequently asked questions
Should I start with USB or Ethernet?
Choose USB when the Home Assistant host can stay near the radio location. Consider Ethernet when the host sits elsewhere and the coordinator location has a wired network. Wi-Fi serial links can add latency or packet loss.
Can I use one coordinator for ZHA and Zigbee2MQTT at the same time?
No. Give each application its own coordinator and network. A device cannot remain joined to both networks at once.
Can I flash firmware from a similar coordinator model?
No. Match firmware to the exact model, radio chip and protocol. If the network is working, keep a backup before making changes.
Sources
- Home Assistant ZHA: compatible adapters, coordinator and network concepts.
- Zigbee2MQTT supported adapters.
- Zigbee2MQTT adapter settings.
- Zigbee2MQTT EmberZNet adapters.
- Zigbee2MQTT zStack adapters.
- Zigbee2MQTT network stability and adapter placement.
- SONOFF ZBDongle-E FAQ: chip differences and two adapters.
- SMLIGHT SLZB model overview and installation/power instructions.
Need help choosing a setup? Talk to Habab Home in Telegram and tell us what you want to connect and where. You do not need to identify the coordinator first; we can start with the room and the problem.
About the service "Home Assistant Zigbee: choose a coordinator, ZHA or Zigbee2MQTT"
Choose a Zigbee coordinator for Home Assistant: USB or wired Ethernet/PoE, ZHA or Zigbee2MQTT, model revisions, firmware and placement.