2024.10.4
Home ▸ Integrations ▸

IKEA TRÅDFRI

The IKEA TRÅDFRI 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 configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file.

Configuration

To add the IKEA TRÅDFRI integration to your Home Assistant instance, use this My button:

IKEA TRÅDFRI can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select IKEA TRÅDFRI.

  • Follow the instructions on screen to complete the setup.

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.

Tip

If you see an “Unable to connect” message, restart the gateway and try again. Don’t forget to assign a permanent IP address to your IKEA Trådfri Gateway on your router or DHCP server.

Note

There is currently no dedicated core integration for the Dirigera hub released in October 2022.

The Dirigera hub can, however, be integrated directly via the HomeKit device integration. This configuration even provides events for motion sensors and buttons, which the original integration lacks.

Troubleshooting

Incorrect security key

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.

Firmware updates

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)

Then restart Home Assistant. When prompted, enter the security key and click configure, just like during initial setup.

Compilation issues

Note

This does not apply to Home Assistant running in Docker Containers, including the default Home Assistant install.

Please make sure you have autoconf installed ($ sudo apt-get install autoconf) if you want to use this integration. Also, installing some dependencies might take considerable time (more than one hour) on slow devices.

Known limitations

  • The TRÅDFRI Shortcut button, Remotes and motion sensor only send information about their battery status, no events, to Home Assistant and thus can’t be used to automate with. If you want to automate with these devices, you need to use something like ZHA, or the HomeKit device integration as mentioned above.
  • The groups you find in the app are not imported into Home Assistant as they are known to cause stability issues. We recommend that you use the native light groups instead.