Setting up a new Zigbee network using Connect ZBT-1 zha
I am running HA in docker under rpi with docker.
I have a HA Connect ZBT-1 stick connected to the rpi.Run Connect ZBT-1 as a Zigbee router
Table of Contents
Plug ZBT-1 directly into the host (RPI)
# lsusb Bus 001 Device 004: ID 10c4:ea60 Silicon Labs CP210x UART Bridge the device is recognised by debain operation system.
Run the Container with --device Flag
To access /dev/ttyUSB0 from Docker Home Assistant, you need to pass the device to the container.
I needed to expose the following volumes to the container,Add the --device parameter to your docker run command:
ls /dev/tty*
/dev/ttyUSB0 docker run -d --name ha --device=/dev/ttyUSB0 --restart=always -e TZ=TZ=Asia/Shanghai -v /data/homeassistant202405:/config --network=host ghcr.io/home-assistant/home-assistant:2025.3.4 https://community.home-assistant.io/t/cant-add-zbt-1-running-ha-in-docker-under-windows/811087
Step 1. Installation
Step 2. Configure Connect ZBT-1
- Go to "Settings > Devices and Services"
- Find "Connect ZBT-1" and click "Add"

- Click "Zigbee"
- Click "Send" and "Finish"
- Added "ZBT-1" to the integration
- Click "Create Network" (if you want to restore the original Zigbee network, select "Upload Manual Backup")
Step 3. Add Zigbee device
There are two paths to operate:
- Settings > Devices & Services > Integration > Zigbee Home Automation > Add Device
- Settings > Devices & Services > Devices > Add new device

Make sure your devices are in pairing mode

Remember to switch the Zigbee device to pairing mode, and then you can see the Zigbee devices that have not yet joined the network~
When I have a HA Connect ZBT-1 stick not connected to the rpi,docker not starting....
docker restart ha
Error response from daemon: Cannot restart container ha: error gathering device information while adding custom device "/dev/ttyUSB0": no such file or directory
Conclusion
Plug ZBT-1 directly into the host (RPI)
Access /dev/ttyUSB0 from Docker Home Assistant by Add the --device parameter to your docker.
useful links
Forming a new Zigbee network with Home Assistant Connect ZBT-1
https://support.nabucasa.com/hc/en-us/articles/26123541989661-Forming-a-new-Zigbee-network-with-Home-Assistant-Connect-ZBT-1
https://neiltw.com/en/home-assistant-connect-zbt1-setup-guide/
https://neiltw.com/home-assistant-connect-zbt1-setup-guide/

Comments
Comments are closed