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.

Illustration: Zigbee2MQTT or ZHA for Home Assistant: which to choose

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.

SONOFF Zigbee dongle and Home Assistant — illustration

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.

Short answer

  • New and want it working fast? ZHA—built into Home Assistant, no MQTT broker, settings in the usual UI.
  • Tinkerer, odd devices, or MQTT elsewhere? Zigbee2MQTT—separate service, rich web UI, anything that speaks MQTT can subscribe.
  • Rule: one coordinator, one stack—never run ZHA and Zigbee2MQTT on the same USB stick.

Architecture

ZHA: Zigbee device → USB stick → Home Assistant (ZHA) Zigbee2MQTT: Zigbee device → USB stick → Zigbee2MQTT → MQTT (Mosquitto) → Home Assistant

Comparison

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

Dongles that work with both

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.

Install ZHA (summary)

  1. Plug stick (extension cable).
  2. Settings → Devices & services—configure if discovered, or add Zigbee Home Automation and pick serial port.
  3. Settings → Connectivity → Zigbee → Add device—reset sensor per manual.

Install Zigbee2MQTT on Home Assistant OS (summary)

  1. Install Mosquitto broker add-on and start it.
  2. Add repository https://github.com/zigbee2mqtt/hassio-zigbee2mqtt.
  3. Install stable Zigbee2MQTT add-on (not Edge unless you know why).
  4. Run the web wizard—pick stick, Wi-Fi channel hint, pair devices.
  5. If ZHA was using the stick, remove ZHA first.

Example manual config for ZBDongle-E (port from ha hardware info):

adapter: ember port: /dev/serial/by-id/usb-…-if00-port0

Switching stacks

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.

Checklist before you migrate

  1. Export a full Home Assistant backup (Settings → System → Backups).
  2. Note your Zigbee channel and Wi-Fi 2.4 GHz channel (avoid overlap).
  3. Remove the old integration (ZHA or Zigbee2MQTT add-on) so the USB stick is released.
  4. Install the new stack, pick the correct serial by-id path, pair one test bulb or sensor first.
  5. Only then move production automations—update entity IDs in scripts.

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).

Common mistakes

  • Two stacks fighting for one /dev/tty*
  • Wi-Fi and Zigbee on overlapping 2.4 GHz channels—fix Wi-Fi channels first, add mains-powered routers (plugs, bulbs)
  • Bulbs switched off at the wall—mesh holes
  • modemmanager grabbing the stick on generic Linux—ZHA docs say to remove it

Who should pick what

FAQ

Can 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.

All smart-home guides

Was this page helpful?

Have a question about this guide or need advice? Ask us here

Torn between two models or stuck on a build? Drop us a line and we will get back to you by email.