IMPORTANT: Before you start, make sure that permit_join: true is set in your configuration.yaml. Otherwise new devices cannot join the network!

Start by checking if your Zigbee device is supported, see Supported devices.

Once you see something similar to New device with address 0x00159d00016da0c8 connected! in the log your device is paired.

Xiaomi

Different devices require different pairing methods. In case you get an Error [ERR_UNHANDLED_ERROR]: Unhandled error. (Cannot get the Node Descriptor of the Device: 0x00158d0001720111) you should try a different pairing method. See Supported devices to figure out if your device is MiJia or Aqara.

NOTE: When you fail to pair a device, try replacing the battery, this could solve the problem.

Belkin WeMo smart LED bulb

Resetting or Restoring the Wemoยฎ Smart LED Bulb, F7C033

IKEA TRADFRI

The factory reset procedure differs between TRADFRI components:

Philips Hue

Factory reset the light bulb see HOWTO: Factory reset a Hue bulb. After resetting the bulb will automatically connect.

Philips Living Colors IRIS (Friends of HUE)

Philips Living Colors IRIS comes with Philips (HUE) Remote Gen 3 (Round Click Wheel). To Pair hold Hold ON and Bottom Left Key (Favorite 1) in Front of the LED until the Light Blinks and turns Orange. If connection was succesfull the Light will turn Green.

Innr

Factory reset using Innr manual reset instructions. After resetting the bulb will automatically connect.

Hive

Follow instructions from How do I reset my Hive Active Light?. After resetting the bulb will automatically connect.

OSRAM

OSRAM Light Bulb

Follow instruction from Manual reset. After resetting the bulb will automatically connect.

OSRAM Smart+ Plug

For the OSRAM Smart+ plug (AB3257001NJ) hold the on/off button until your hear a click (+- 10 seconds).

OSRAM Smart+ Switch Mini

For the OSRAM Smart+ Switch Mini (AC0251100NJ) hold the Middle and Arrow Down Buttons for 10 Seconds to Reset the Device. Hold the Middle and Arrow Up Buttons for 3 Seconds to connect. If the Switch is connected hold Middle and Arrow Up Buttons for 3 Seconds to disconnect.

OSRAM Switch 4x-LIGHTIFY

For the OSRAM Switch 4x-LIGHTIFY (AB371860055) hold the Bottom Left and Top Right Button for 3 Seconds to connect.

PLUG EDP RE:DY

Factory reset the plug (hold the switch button for >10sec). After resetting the switch will automatically connect.

Netvox power socket

Factory reset by: