2025.10.4
Home ▸ Integrations ▸

Velux

Velux integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] for Home Assistant allows you to connect to a Velux KLF 200 interface, to control io-homecontrol devices like windows and blinds. The module allows you to start scenes configured within KLF 200.

At least firmware version > 2.0.0.0 is required on the KLF 200 device. The firmware images may be obtained from the vendor’s website and may be imported via the web interface of your KLF 200.

There is currently support for the following device types within Home Assistant:

  • Binary sensor (reports rain detection for windows that support it)
  • Cover
  • Light
  • Scene

Rain sensors of supported windows do not report automatically and must be polled every 5 minutes. For this reason, they are disabled by default, because polling uses more radio bandwidth and battery power than simply reporting changed window positions.

Prerequisites

  1. Make sure you have the password for your gateway’s wireless access point.
    • You’ll find it printed on the underside of your KLF 200 device.
    • It is not the web login password.
  2. Reboot or power cycle the KLF 200 device.
    • You must complete the configuration within 5 minutes of rebooting the device while its Wi-Fi access point is still visible.
  3. During configuration, keep your Home Assistant connected to your regular network.
    • Don’t connect to the device’s wireless access point.

Configuration

To add the Velux integration to your Home Assistant instance, use this My button:

Velux 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:

During configuration, you will be asked for a hostname and password:

Hostname

The IP address or hostname of the KLF 200 gateway. You can find it in your router.

Password

The password of the gateway’s wireless access point. You can find it printed on the underside of the device. It is not the web login password.

Remember: You must complete the configuration within 5 minutes of rebooting the KLF 200 gateway. If you can’t complete in time and setup fails, power cycle the device and try again.

Actions

Action velux.reboot_gateway

Reboots the configured KLF 200 gateway.

In Home Assistant versions up to 2024.12.x, it was recommended to create an automation to reboot the KLF 200 gateway before shutting down or restarting Home Assistant. This automated reboot is now built into the integration, so you no longer need to create a separate automation.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.

Unsupported Hardware

Velux KLF 150

The Velux KLF 150 is not supported by this integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], even though Velux markets it as the replacement for the now-discontinued KLF 200. Unlike the KLF 200, the KLF 150 does not provide a local API that Home Assistant can communicate with directly.

However, there is a community project that bridges the KLF 150’s GPIO interface with MQTT. Using this project with additional hardware, you can control your KLF 150 through the MQTT Cover integration.

Velux Active (KIX 300)

The Velux Active (KIX 300) set is not supported by this integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more]. To integrate Velux Active (KIX 300) with Home Assistant, you can use the HomeKit Controller integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] and get full control over your windows, curtains, covers, the air quality sensor KLA 300, etc.

Add the Velux Active gateway using HomeKit pairing (with the pairing code on the sticker at the bottom of the Velux Active gateway) and the devices connected to the gateway - including sensors - will be automatically discovered and added to Home Assistant.