2025.10.3
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.

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.