tradfri integration allows you to connect your IKEA Trådfri Gateway to Home Assistant. The gateway can control compatible Zigbee-based lights (certified Zigbee Light Link products) connected to it. Home Assistant will automatically discover the gateway’s presence on your local network if
discovery: is present in your
You will be prompted to configure the gateway through the Home Assistant interface. The configuration process is very simple: when prompted, enter the security key printed on the sticker on the bottom of the IKEA Trådfri Gateway, then click configure.
You can add the following to your
configuration.yaml file if you are not using the
# Example configuration.yaml entry tradfri: host: IP_ADDRESS
Fatal DTLS error: code 20 might indicate a missing or incorrect security key. Pay close attention as e.g., “I” and “l” can easily be confused.
After updating your IKEA Trådfri Gateway firmware it might be necessary to repeat the configuration process. One error you might experience after a firmware update is
Fatal DTLS error: code 115. If you encounter problems:
- when configured using the integration: remove the integration through Settings > Integrations > Tradfri > delete (trash can icon)
- with manual configuration: delete the
.tradfri_psk.conffile in your
/.homeassistantdirectory if using Home Assistant Core)
Then restart Home Assistant. When prompted, enter the security key and click configure, just like during initial setup.
Please make sure you have
autoconf installed (
$ sudo apt-get install autoconf) if you want to use this component. Also, installing some dependencies might take considerable time (more than one hour) on slow devices.
Do not use the
api_key variable in
configuration.yaml. The API key is only needed once at initial setup and will be stored.
- The TRÅDFRI Shortcut button sends no events to Home Assistant so it cannot be used to automate with; it does report battery status.