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

Plug ZBT-1 directly into the host (RPI)

When I run lsusb, I can see the device:
# lsusb
output
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
Note:
Otherwise,Connect ZBT-1 can't discoverde by ha.

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

  1. Go to "Settings > Devices and Services"
  2. Find "Connect ZBT-1" and click "Add"

  1. Click "Zigbee" 
  1. Click "Send" and "Finish"
  1. Added "ZBT-1" to the integration
  1. 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:

  1. Settings > Devices & Services > Integration > Zigbee Home Automation > Add Device
  2. Settings > Devices & Services > Devices > Add new device

zha-connetc-ZBT-1-2.png

 

Make sure your devices are in pairing mode

zha-connetc-ZBT-2.png

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