Connecting to Home Assistant via ZHA


Preparation #



Step 1: Add Integration #



In most cases, once the device is connected to the operating system, it will be automatically discovered by Home Assistant. Go to Settings > Devices & Services, and click ADD to start the configuration.


Step 2: Configure the Dongle #



After clicking the ADD button, follow the prompts to configure the Dongle. You will need to select a network initialization method:

  1. Restore from previous network backup: Used when replacing the Zigbee coordinator. Restores based on the last available network backup.
  2. Keep existing network settings: Used when the Zigbee coordinator remains the same and ZHA integration is re-added. Generally not recommended.
  3. Manually upload network backup: Used when manually migrating network data during HA migration.
  4. Erase and create a new network: Used to create a new Zigbee network by erasing existing network data.


Step 3: Add a Zigbee Sub-device #



Put the Zigbee sub-device into pairing mode. Then go to the ZHA Integration > Devices page, click Add Device, and the integration will begin scanning and automatically adding the Zigbee sub-device.


Troubleshooting #


If the device is not automatically discovered due to special circumstances, you can manually add the ZHA integration:
Settings → Devices & Services → Add Integration → Search for ZHA → Manually select device path → Submit

What are your feelings

Updated on July 20, 2026