HA Add Zigbee Device

How to Add a Zigbee Device to LinuxBox

There are two main ways to support the Zigbee protocol in Home Assistant:

• ZHA (Zigbee Home Automation) — built-in integration
• Zigbee2MQTT — external service via MQTT

There are also two main approaches to adding devices:

• Using a web browser
• Using the Home Assistant App

ZHA Method

Using a Web Browser

1. Ensure the LinuxBox is connected to the network and you know its IP address.
2. Enter http://<ip_address>:8123 in your browser to access Home Assistant.
3. Go to Settings → Devices & Services → Add Integration, type "zha", and add the Zigbee device.
4. Follow the instructions for your specific Zigbee device to complete pairing.

Using the Home Assistant App

1. The app can automatically discover Home Assistant on the local network.
2. If you have previously connected to another HA instance, delete the old configuration first.
3. In the app, tap Menu → Settings → Devices & Services → Add Integration, type "zha", and add the device.

4. Follow the instructions for your specific Zigbee device to complete pairing.

Zigbee2MQTT Method

Using a Web Browser

Make sure the LinuxBox is connected to the network and you know its IP address.

Using the Home Assistant App

Unlike the web browser method, the app can automatically discover Home Assistant on the local network.