Zigbee Home Automation

Zigbee Home Automation integration for Home Assistant allows you to connect many off-the-shelf Zigbee based devices to Home Assistant, using one of the available Zigbee radio modules compatible with zigpy (an open source Python library implementing a Zigbee stack, which in turn relies on separate libraries which can each interface a with Zigbee radio module a different manufacturer).

There is currently support for the following device types within Home Assistant:

  • Binary Sensor
  • Sensor
  • Light
  • Switch
  • Fan

Known working Zigbee radio modules:


To configure the component, a zha section must be present in the configuration.yaml, and the path to the serial device for the radio and path to the database which will persist your network data is required.

# Example configuration.yaml entry
  usb_path: /dev/ttyUSB2
  database_path: /home/homeassistant/.homeassistant/zigbee.db

Configuration Variables


(string)(Optional)One of ezsp, xbee or deconz.

Default value: ezsp


(string)(Required)Path to the serial device for the radio.


(integer)(Optional)Baud rate of the serial device.

Default value: 57600


(string)(Required)Full path to the database which will keep persistent network data.


(boolean)(Optional)Enable quirks mode for devices where manufacturers didn’t follow specs.

Default value: true

To add new devices to the network, call the permit service on the zha domain. Do this by clicking the Service icon in Developer tools and typing zha.permit in the Service dropdown box. Next, follow the device instructions for adding, scanning or factory reset.

In case you want to add Philips Hue bulbs that have previously been added to another bridge, have a look at: https://github.com/vanviegen/hue-thief/