Zigbee2MQTT or ZHA for Home Assistant: which to choose
ZHA vs Zigbee2MQTT: architecture, dongles, setup steps, migration traps and who each suits—based on official docs, November 2026.
Getting started
Home Assistant
Buying
ZHA vs Zigbee2MQTT: architecture, dongles, setup steps, migration traps and who each suits—based on official docs, November 2026.


AI-generated illustration
Quick answer (November 2026) — For most homes, start with ZHA (Zigbee Home Automation—the built-in Home Assistant Zigbee integration). Choose Zigbee2MQTT if you already run an MQTT broker (Message Queuing Telemetry Transport, a lightweight publish/subscribe bus) for Node-RED or scripts outside Home Assistant. Full hub: smart-home guides.
Also available in French. Canadian readers: same content on /ca/smart-home/ with Amazon.ca buying links.
You plugged a Zigbee (low-power 2.4 GHz mesh radio for sensors and bulbs) USB stick into your Pi or Home Assistant Green and Home Assistant offers ZHA or Zigbee2MQTT. Both run your sensors, plugs and bulbs—but differently. This guide follows the ZHA integration docs and Zigbee2MQTT getting started (November 2026). We did not benchmark speed or range—no invented performance numbers.

Illustration: a USB Zigbee coordinator is the “brain” of your mesh; keep it on a short USB extension away from Wi-Fi interference.
Readers in Canada: the same steps apply on Windows, macOS and Home Assistant OS. On /ca/ URLs, prefer Amazon.ca for dongles and accessories—links below include Canadian listings where available. See also our Canadian buying guides.
ZHA: Zigbee device → USB stick → Home Assistant (ZHA) Zigbee2MQTT: Zigbee device → USB stick → Zigbee2MQTT → MQTT (Mosquitto) → Home Assistant
| ZHA | Zigbee2MQTT | |
|---|---|---|
| Runs on | Inside Home Assistant | Add-on or separate host |
| MQTT broker | Not needed | Required (Mosquitto) |
| Setup | Few clicks, auto-detect common sticks | Mosquitto, repo, add-on, wizard |
| UI | Home Assistant settings | Dedicated Zigbee2MQTT frontend |
| Radio families (docs) | Silicon Labs (EZSP), TI (ZNP), deCONZ, ZiGate | TI (zStack) and Silicon Labs (Ember) recommended; deCONZ supported |
| Odd devices | “Quirks” in ZHA | “Converters” in Z2M |
| OTA firmware | Limited vendor list | Community firmware repo |
| Network backup | Automatic; migration between some sticks in ZHA | Coordinator backup (zStack/Ember); changing stack often means re-pairing |
| Use sensors outside HA | No | Yes—Node-RED, scripts, etc. |
| Minimum hardware | Same as HA | 64-bit; Pi 4+ advised for the add-on |
Silicon Labs and Texas Instruments sticks suit both stacks. The SONOFF ZBDongle-E (EFR32MG21) is listed for ZHA; Zigbee2MQTT uses the ember adapter — see our SONOFF brand page for context on plugs and dongles. Home Assistant Connect ZBT-2 is the official stick (MG24)—Zigbee or Thread. Details: best Zigbee dongle.
| Dongle | Notes |
|---|---|
| SONOFF ZBDongle-E | Official Sonoff page. The price is on the shop of the country. |
| Home Assistant Connect ZBT-2 | Home Assistant Connect ZBT-2 |
Zigbee2MQTT tip: use a USB extension so the stick sits away from the Pi—first fix for pairing drops and 2.4 GHz clash with Wi-Fi.
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt.Example manual config for ZBDongle-E (port from ha hardware info):
adapter: ember port: /dev/serial/by-id/usb-…-if00-port0
Official migration without re-pairing is documented within ZHA (coordinator stick to stick). Moving ZHA ↔ Zigbee2MQTT usually means re-pairing every device—decide before you deploy twenty sensors.
If Zigbee2MQTT logs ember or EZSP adapter errors on a SONOFF stick, see our troubleshooting pattern (French catalog page mirrors the fix): driver must match ZBDongle-E (ember) vs ZBDongle-P (zstack).
/dev/tty*modemmanager grabbing the stick on generic Linux—ZHA docs say to remove itCan I run ZHA and Zigbee2MQTT on one stick?
No—one USB coordinator, one stack. Two sticks means two separate Zigbee networks (rare at home).
Is Zigbee2MQTT “more pro”?
It exposes more detail and MQTT topics; that does not automatically mean better reliability for a family setup.
Does ZHA need Mosquitto?
No. Zigbee2MQTT does.
Pi 3 enough for Zigbee2MQTT?
Official docs recommend at least a Raspberry Pi 4 for the add-on; ZHA on a Pi 3 can still work for small networks.
Where to buy dongles in Canada?
Use Amazon.ca listings in our best Zigbee dongle table (ZBDongle-E and ZBT-2 rows include CA links).
More: Install Home Assistant on Pi 5 · Zigbee temperature sensor · best Zigbee dongle · smart-home protocols · SONOFF brand context.
Was this page helpful?
Thank you!
What should we improve?
Torn between two models or stuck on a build? Drop us a line and we will get back to you by email.
Cookies and analytics
We use Google Analytics 4 to understand how the site is used (page views, navigation). It is only switched on if you accept. Declining does not stop you using the site. More: cookie settings and privacy policy (in French).