Setting up a Zigbee coordinator for Home Assistant
Updated
A Zigbee USB coordinator is cheap, but placement and the ZHA or Zigbee2MQTT choice decide whether your network is stable. Here is how to set it up, where to plug it in and how to grow the mesh.
As an Amazon Associate we earn from qualifying purchases. Links to Amazon on this page are affiliate links: buying through them costs you nothing extra.
What a coordinator does
A Zigbee network needs one coordinator: the device that forms the network and lets Home Assistant talk to it. It is a small USB radio, usually $20–$50, that you plug into the computer running Home Assistant. Zigbee is a self-healing mesh on the 2.4 GHz band, with AES-128 encryption, according to the Connectivity Standards Alliance, and mains-powered devices such as plugs and bulbs relay messages for other devices. If you are still deciding between protocols, read Matter vs Zigbee first.
Check one thing before you buy: the coordinator must be supported by the software you plan to use. ZHA works with coordinators compatible with the zigpy library, and lists tested adapters. Zigbee2MQTT recommends three coordinator types and marks others as unmaintained or experimental. Always check the supported-adapter list of the project, not just the product page. Both projects also warn that connecting a coordinator over Wi-Fi is less stable, so use USB, or an Ethernet-connected adapter if the radio must be remote.
ZHA or Zigbee2MQTT
| ZHA | Zigbee2MQTT | |
|---|---|---|
| What it is | Built into Home Assistant | A separate program that talks to Home Assistant through an MQTT broker |
| Extra software | None | The program itself and an MQTT broker (Mosquitto is the recommended one) |
| Where you manage the network | Inside Home Assistant | Its own web interface, plus Home Assistant |
| Changing adapters later | Can migrate between several radio families if the backup was made in ZHA | May require re-pairing all your devices in some cases |
| Good fit | You want the simplest path | You want a separate network that does not depend on Home Assistant restarts |
Both are widely used and both work with Zigbee 3.0 devices. Look up each device you own in the project’s supported-devices list before choosing; the lists change often. Pick one stack per coordinator. You cannot run ZHA and Zigbee2MQTT on the same radio at the same time.
Where to plug it in
- Use a USB 2.0 port. ZHA’s documentation says USB 3.x ports, devices and cables are known sources of interference for 2.4 GHz radios. If your computer only has USB 3 ports, ZHA suggests a powered USB 2.0 hub.
- Add an extension cable. Zigbee2MQTT says an extension cable of 50 cm (about 20 inches) already reduces interference noticeably. ZHA recommends a long shielded cable. Do not put the adapter right next to USB or HDMI ports.
- Keep it away from other radios and drives. Stay clear of Wi-Fi routers and SSDs. Zigbee2MQTT warns that a spot close to USB or HDMI can kill the radio signal entirely.
- Place it centrally. ZHA suggests the middle of the house, away from walls, floors, electrical wiring and big appliances. Try a different orientation of the stick or its antenna if range is poor.
If your Home Assistant computer sits in a closet or basement corner, move the coordinator, not just the computer: a longer cable or a coordinator connected through an Ethernet adapter helps more than a stronger antenna.
Wi-Fi interference and channels
Zigbee and Wi-Fi share the 2.4 GHz band and can interfere with each other. ZHA’s advice is to keep its default channel, and notes that channels 15, 20 and 25 are generally recommended for compatibility with Zigbee devices. If you have interference, set your Wi-Fi router to a fixed channel first. Changing the Zigbee channel later may require re-pairing some devices, so choose before you add many. Our Zigbee and Wi-Fi interference guide goes deeper.
Build the mesh in the right order
- Pair mains-powered devices first. Almost all AC-powered Zigbee devices act as routers, per Zigbee2MQTT, and routers extend the range for the battery sensors that follow. Plugs and bulbs both qualify; relays without a neutral wire are the usual exception.
- Spread routers out. A coordinator has a limit of 32 direct children, according to ZHA, but routers let the network reach hundreds of devices.
- Pair each device near a router. Then place it in its final position.
- Keep routers powered. If you switch off a smart bulb at a wall switch, the devices that relied on it lose their path.
- Add battery sensors last. Door sensors, motion sensors and leak sensors are not routers, so they depend on the routers you built.
Some routers of mediocre quality can cause routing errors, so if one device keeps dropping, test the network without it. Matter-over-Zigbee bridges are a different topic, covered in Matter bridge and Zigbee devices.
Firmware, backups and troubleshooting
- Update the coordinator firmware. ZHA recommends doing this before troubleshooting. Most third-party adapters are updated with the manufacturer’s tool, not through Home Assistant.
- Take a Home Assistant backup before changing the radio or the channel. If you replace the radio, follow the ZHA migration steps instead of starting over.
- Do not reset the stick casually. Re-flashing an adapter can keep devices paired in some cases, but swapping between certain adapters may force you to re-pair everything.
- Check for one broken device. A single misbehaving router can make the whole mesh seem unstable.
Shop by need
Home Assistant user adding Zigbee for the first time
What to look for: Zigbee 3.0 USB coordinator listed in the ZHA or Zigbee2MQTT adapter lists, external antenna, current firmware
Typical price: $20–$50
See options on AmazonComputer is in a closet or has noisy USB ports
What to look for: shielded USB 2.0 extension cable, 3 to 6 ft, with ferrite cores
Typical price: $8–$20
See options on AmazonOnly USB 3 ports available
What to look for: powered USB 2.0 hub, separate power supply, short upstream cable
Typical price: $10–$25
See options on AmazonLarge house or weak signal in far rooms
What to look for: mains-powered Zigbee plug or repeater that acts as a router, not a battery sensor
Typical price: $10–$25
See options on AmazonFrequently asked questions
Is ZHA or Zigbee2MQTT easier?
ZHA is easier to start with because it is built into Home Assistant. Zigbee2MQTT needs a separate program and an MQTT broker but gives you its own interface. Check that the devices you own are supported by your choice.
Why does my Zigbee network drop devices?
Common causes are a USB 3 port or nearby electronics interfering with the radio, a coordinator without an extension cable, too few mains-powered routers and Wi-Fi on a crowded channel. Fix placement and routers first.
How many Zigbee devices can one coordinator handle?
ZHA’s documentation says a coordinator is limited to 32 direct children, but routers allow the network to grow to hundreds of devices.
Do I need a coordinator if I use Matter?
Only for Zigbee devices. Matter devices over Wi-Fi need no coordinator; Matter devices over Thread need a Thread border router, which is a different piece of hardware.