KLF200 - io-homecontrol integration for Gladys Assistant
Discover and control io-homecontrol shutters already paired to a Velux KLF200 gateway.
Published by vincentBesseau
- Devices
- Version 1.0.3
- Requires Gladys >=4.86.0
- ★ 0
This is the user documentation of the integration. Gladys re-hosts this file and shows a permanent Documentation link to it in the Configuration screen — it is when configuring that the user needs it most.
What you get
Every io-homecontrol® shutter/window already paired to your Velux KLF200 gateway (via the Velux app or the gateway's own pairing UI) shows up automatically, each with two controllable features:
- Position — a 0–100% slider.
- State — an open / stop / closed button.
Both are polled every 60 seconds, so a move made outside Gladys (physical remote, Velux app) is reflected automatically within a minute.
Configuration
- Open the Configuration tab of the integration.
- Fill in the KLF200 gateway's IP address and password (set on the gateway itself). Optionally paste its TLS fingerprint to pin the certificate.
- Save: the integration connects to the gateway and the shutters it already knows about appear in the Discovery tab, ready to be added.
Known limitation
The KLF200 only accepts a single connection at a time. If the gateway was recently used by another client (the Velux app, another integration…) a connection attempt can be briefly refused — the integration retries automatically every 30 seconds and needs no manual action.
Troubleshooting
The integration logs every connection attempt, discovery and command: check the integration logs
from the Gladys UI (or docker logs on the host).
Configuration settings
These are the settings KLF200 - io-homecontrol asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| KLF200 gateway | section | No | Shutters must already be paired via the Velux app or the gateway's own UI. |
| KLF200 IP address | string | Yes | |
| KLF200 password | secret | Yes | |
| TLS fingerprint (optional) | string | No | Leave empty to skip certificate pinning. |
How to install KLF200 - io-homecontrol in Gladys
- In Gladys, open Integrations: KLF200 - io-homecontrol appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/vincentbesseau/gladys-klf-200-io-homecontrol:1.0.3), 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/vincentBesseau/gladys-klf-200-io-homecontrol.
KLF200 - io-homecontrol requires Gladys >=4.86.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
KLF200 - io-homecontrol 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 vincentBesseau, not by the Gladys core team.
- Browse all external integrations
- Discover the native integrations built into Gladys
- Build and publish your own external integration
- Source code on GitHub — source of this documentation