IKEA DIRIGERA & TRÅDFRI smart home integration, free and open source
IKEA smart home devices through the DIRIGERA hub or the TRÅDFRI gateway, locally.
Published by LM1LC3N7
- Devices
- Version 0.1.2
- Requires Gladys >=5.1.0
- ★ 0
Control your IKEA smart home devices from Gladys, through your DIRIGERA hub or your TRÅDFRI gateway, on your local network: no cloud, no IKEA account. The lights, plugs, blinds, air purifiers and sensors paired with the gateway appear in the Discovery tab of Gladys, ready to be added. Unofficial integration, not affiliated with IKEA.
Development version (0.1). Built from the documented local APIs of both gateways and tested against simulated gateways, not yet against real hardware. Your feedback is welcome on the GitHub repository.
What you get
| IKEA device | In Gladys |
|---|---|
| Bulbs, lamps, LED strips | a light: on/off, brightness, color temperature (white spectrum), color (CWS) |
| TRETAKT, INSPELNING, TRÅDFRI plugs | a switch; power, voltage, current and energy for the INSPELNING |
| FYRTUR, KADRILJ, PRAKTLYSING, TREDANSEN blinds | a shutter: open, close, stop, position; the battery |
| STARKVIND air purifier | mode (off, low, medium, high, auto), speed, PM2.5, filter life, child lock |
| VINDSTYRKA, ALPSTUGA, TIMMERFLOTTE | temperature, humidity, PM2.5, VOC index, CO₂ (depending on the model) |
| PARASOLL, BADRING, VALLHORN, TRÅDFRI motion sensor | opening, water leak, motion, light level; the battery |
| SOMRIG, TRÅDFRI shortcut button, BILRESA (DIRIGERA) | one button per key and the IKEA remote button scene trigger |
| Other remotes | the battery |
The devices are updated in real time: the DIRIGERA hub pushes its events on a websocket, the TRÅDFRI gateway notifies every change (CoAP observe).
Installation
DIRIGERA hub
- Install the integration, then open its Configuration tab.
- Click Pair the DIRIGERA hub, then press the action button under the hub (the small button on its bottom) within 90 seconds.
- Once paired, open the Discovery tab and add the devices you want.
TRÅDFRI gateway
- Find the security code printed under the gateway (16 characters, next to the QR code).
- Click Pair the TRÅDFRI gateway, type the code, confirm.
- Open the Discovery tab and add the devices.
The code is only used once, to create an access of its own for Gladys: it is not kept. Both gateways can be paired at the same time.
Gateway address
The gateways are found on the network by themselves (mDNS, through Gladys).
If the search fails (another network, a router that filters multicast), type
the IP address of the gateway in the configuration (for example
192.168.1.20; a .local name does not work from the integration container).
Give the gateway a fixed address in your router if you can. Without a typed
address, a gateway whose address changed is found again by itself.
The Find the IKEA gateways on the network button lists what answers.
Scenes
- Shortcut buttons and remotes paired with a DIRIGERA hub become "button" features (single press, double press, long press), usable in the "Device state change" trigger.
- The IKEA remote button scene trigger receives every press, filtered by remote, button number and press type.
- The TRÅDFRI gateway does not forward the presses of its remotes nor the detections of its motion sensors: there, only their battery level is available. Move them to a DIRIGERA hub to use them in Gladys scenes.
Troubleshooting
- "not found on the network": type the IP address of the gateway.
- "the hub refused the access": the access was removed from the IKEA app, or the hub was reset: pair it again.
- "was not issued by IKEA": the address does not point to a DIRIGERA hub, or its certificate changed. If it really is your hub, turn off Check that the hub certificate was issued by IKEA.
- "the gateway refused the key" (TRÅDFRI): the gateway was reset: pair it again with its security code.
- The button presses of a remote do not show: only the remotes that the DIRIGERA hub exposes as shortcut buttons send their presses; a remote linked directly to lights controls them without telling the hub.
Privacy
Everything stays on your network: the integration only talks to your gateway, directly. The access given by the hub (DIRIGERA) or the key given by the gateway (TRÅDFRI) is stored by Gladys, never shown in the interface and never written in the logs.
Configuration settings
These are the settings IKEA DIRIGERA & TRÅDFRI asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Your IKEA devices, on your local network | section | No | Lights, plugs, blinds, STARKVIND air purifiers, sensors and remotes paired with a DIRIGERA hub or a TRÅDFRI gateway, without the cloud. DIRIGERA: press "Pair the DIRIGERA hub" below, then the action button under the hub within 90 seconds. TRÅDFRI: type the security code printed under the gateway in "Pair the TRÅDFRI gateway". The gateways are found on the network by themselves; type an address only if the search fails (its IP address, a .local name does not work from the integration container). Unofficial integration, not affiliated with IKEA. |
| DIRIGERA hub address | string | No | Leave empty: the hub is found on the network. Otherwise its IP address, for example 192.168.1.20. |
| Check that the hub certificate was issued by IKEA | boolean | No | Turn off only if the connection fails with a certificate error and the address is really your hub's. |
| TRÅDFRI gateway | section | No | The TRÅDFRI gateway (the white square box sold until 2022). Its remotes and motion sensors only report their battery: the gateway never forwards their presses. A DIRIGERA hub does, for the shortcut buttons. |
| TRÅDFRI gateway address | string | No | Leave empty: the gateway is found on the network. Otherwise its IP address, for example 192.168.1.21. |
How to install IKEA DIRIGERA & TRÅDFRI in Gladys
- In Gladys, open Integrations: IKEA DIRIGERA & TRÅDFRI appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/lm1lc3n7/gladys-ikea:0.1.2), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/LM1LC3N7/gladys-ikea.
IKEA DIRIGERA & TRÅDFRI requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
IKEA DIRIGERA & TRÅDFRI is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by LM1LC3N7, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation