{"id":26904,"date":"2026-09-16T14:42:03","date_gmt":"2026-09-16T14:42:03","guid":{"rendered":"https:\/\/netguide.io\/smart-home\/integrating-velux-kig-300-in-an-iot-vlan-into-home-assistant-via-avahi\/"},"modified":"2026-09-16T14:42:04","modified_gmt":"2026-09-16T14:42:04","slug":"integrating-velux-kig-300-in-an-iot-vlan-into-home-assistant-via-avahi","status":"publish","type":"post","link":"https:\/\/netguide.io\/smart-home\/en\/integrating-velux-kig-300-in-an-iot-vlan-into-home-assistant-via-avahi\/","title":{"rendered":"Integrating Velux KIG 300 in an IoT VLAN into Home Assistant via Avahi"},"content":{"rendered":"<div id=\"netgu-1168988632\" class=\"netgu-before-content netgu-entity-placement\"><script async src=\"\/\/pagead2.googlesyndication.com\/pagead\/js\/adsbygoogle.js?client=ca-pub-6258556257245998\" crossorigin=\"anonymous\"><\/script><ins class=\"adsbygoogle\" style=\"display:block;\" data-ad-client=\"ca-pub-6258556257245998\" \ndata-ad-slot=\"3494115342\" \ndata-ad-format=\"auto\"><\/ins>\n<script> \n(adsbygoogle = window.adsbygoogle || []).push({}); \n<\/script>\n<\/div><p>In this guide, you will learn how to make the Velux KIG 300 gateway discoverable via the HomeKit Controller integration in <a href=\"https:\/\/netguide.io\/smart-home\/category\/home-assistant\/\" data-internallinksmanager029f6b8e52c=\"2\" title=\"Home Assistant\">Home Assistant<\/a> when the gateway and <a href=\"https:\/\/netguide.io\/smart-home\/category\/home-assistant\/\" data-internallinksmanager029f6b8e52c=\"2\" title=\"Home Assistant\">Home Assistant<\/a> reside in separate network segments. This setup is intended for advanced users operating a dedicated IoT network.<\/p>\n\n<h2>Prerequisites<\/h2>\n<ul>\n  <li>A Linux-based gateway (such as a Raspberry Pi) acting as a bridge between the regular LAN and the IoT VLAN.<\/li>\n  <li>Appropriate permissions to modify the configuration on this gateway system.<\/li>\n  <li>Avahi is installed on the gateway system.<\/li>\n  <li>A working <a href=\"https:\/\/netguide.io\/smart-home\/category\/home-assistant\/\" data-internallinksmanager029f6b8e52c=\"2\" title=\"Home Assistant\">Home Assistant<\/a> instance on the LAN and a configured Velux KIG 300 on the IoT VLAN (2.4 GHz Wi-Fi).<\/li>\n<\/ul>\n\n<h2>Step 1: Back Up the Configuration File<\/h2>\n<p>Before modifying network services, create a backup copy of your existing Avahi configuration so you can revert any misconfigurations at any time.<\/p>\n\n<h2>Step 2: Enable the mDNS Reflector in Avahi<\/h2>\n<p>If the KIG 300 resides in a separate IoT VLAN with its own IP range, the HomeKit Controller integration in <a href=\"https:\/\/netguide.io\/smart-home\/category\/home-assistant\/\" data-internallinksmanager029f6b8e52c=\"2\" title=\"Home Assistant\">Home Assistant<\/a> on the regular LAN will not discover it automatically. To make the gateway discoverable across networks, configure Avahi as an mDNS reflector. Open the Avahi configuration file and adjust the <code>[reflector]<\/code> section as follows:<\/p>\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"Code-Pro-JetBrains-Mono\" style=\"font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)\"><span style=\"display:block;padding:16px 0 0 16px;margin-bottom:-1px;width:100%;text-align:left;background-color:#24292e\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"54\" height=\"14\" viewBox=\"0 0 54 14\"><g fill=\"none\" fill-rule=\"evenodd\" transform=\"translate(1 1)\"><circle cx=\"6\" cy=\"6\" r=\"6\" fill=\"#FF5F56\" stroke=\"#E0443E\" stroke-width=\".5\"><\/circle><circle cx=\"26\" cy=\"6\" r=\"6\" fill=\"#FFBD2E\" stroke=\"#DEA123\" stroke-width=\".5\"><\/circle><circle cx=\"46\" cy=\"6\" r=\"6\" fill=\"#27C93F\" stroke=\"#1AAB29\" stroke-width=\".5\"><\/circle><\/g><\/svg><\/span><span role=\"button\" tabindex=\"0\" style=\"color:#e1e4e8;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><pre class=\"code-block-pro-copy-button-pre\" aria-hidden=\"true\"><textarea class=\"code-block-pro-copy-button-textarea\" tabindex=\"-1\" aria-hidden=\"true\" readonly>[reflector]\nenable-reflector=yes\nreflect-ipv=no<\/textarea><\/pre><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki github-dark\" style=\"background-color: #24292e\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color: #B392F0\">[reflector]<\/span><\/span>\n<span class=\"line\"><span style=\"color: #F97583\">enable-reflector<\/span><span style=\"color: #E1E4E8\">=yes<\/span><\/span>\n<span class=\"line\"><span style=\"color: #F97583\">reflect-ipv<\/span><span style=\"color: #E1E4E8\">=no<\/span><\/span><\/code><\/pre><\/div>\n\n<h2>Step 3: Restart the Avahi Service<\/h2>\n<p>To apply the modified settings and have Avahi operate as a reflector, restart the service.<\/p>\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"Code-Pro-JetBrains-Mono\" style=\"font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)\"><span style=\"display:block;padding:16px 0 0 16px;margin-bottom:-1px;width:100%;text-align:left;background-color:#24292e\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"54\" height=\"14\" viewBox=\"0 0 54 14\"><g fill=\"none\" fill-rule=\"evenodd\" transform=\"translate(1 1)\"><circle cx=\"6\" cy=\"6\" r=\"6\" fill=\"#FF5F56\" stroke=\"#E0443E\" stroke-width=\".5\"><\/circle><circle cx=\"26\" cy=\"6\" r=\"6\" fill=\"#FFBD2E\" stroke=\"#DEA123\" stroke-width=\".5\"><\/circle><circle cx=\"46\" cy=\"6\" r=\"6\" fill=\"#27C93F\" stroke=\"#1AAB29\" stroke-width=\".5\"><\/circle><\/g><\/svg><\/span><span role=\"button\" tabindex=\"0\" style=\"color:#e1e4e8;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><pre class=\"code-block-pro-copy-button-pre\" aria-hidden=\"true\"><textarea class=\"code-block-pro-copy-button-textarea\" tabindex=\"-1\" aria-hidden=\"true\" readonly>sudo systemctl restart avahi-daemon<\/textarea><\/pre><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki github-dark\" style=\"background-color: #24292e\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color: #B392F0\">sudo<\/span><span style=\"color: #E1E4E8\"> <\/span><span style=\"color: #9ECBFF\">systemctl<\/span><span style=\"color: #E1E4E8\"> <\/span><span style=\"color: #9ECBFF\">restart<\/span><span style=\"color: #E1E4E8\"> <\/span><span style=\"color: #9ECBFF\">avahi-daemon<\/span><\/span><\/code><\/pre><\/div>\n\n<h2>Step 4: Restart Home Assistant and Pair the Device<\/h2>\n<p>Restart the Home Assistant host or service via the web interface so the device can be detected. Afterwards, the Velux KIG 300 will appear in Home Assistant under notifications or as a new HomeKit device. To pair it, enter the HomeKit pairing code located on the back of the KIG 300 gateway.<\/p>\n\n<h2>Verification<\/h2>\n<p>First, verify on the gateway that the Avahi service is running without errors:<\/p>\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"Code-Pro-JetBrains-Mono\" style=\"font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)\"><span style=\"display:block;padding:16px 0 0 16px;margin-bottom:-1px;width:100%;text-align:left;background-color:#24292e\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"54\" height=\"14\" viewBox=\"0 0 54 14\"><g fill=\"none\" fill-rule=\"evenodd\" transform=\"translate(1 1)\"><circle cx=\"6\" cy=\"6\" r=\"6\" fill=\"#FF5F56\" stroke=\"#E0443E\" stroke-width=\".5\"><\/circle><circle cx=\"26\" cy=\"6\" r=\"6\" fill=\"#FFBD2E\" stroke=\"#DEA123\" stroke-width=\".5\"><\/circle><circle cx=\"46\" cy=\"6\" r=\"6\" fill=\"#27C93F\" stroke=\"#1AAB29\" stroke-width=\".5\"><\/circle><\/g><\/svg><\/span><span role=\"button\" tabindex=\"0\" style=\"color:#e1e4e8;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><pre class=\"code-block-pro-copy-button-pre\" aria-hidden=\"true\"><textarea class=\"code-block-pro-copy-button-textarea\" tabindex=\"-1\" aria-hidden=\"true\" readonly>sudo systemctl status avahi-daemon<\/textarea><\/pre><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki github-dark\" style=\"background-color: #24292e\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color: #B392F0\">sudo<\/span><span style=\"color: #E1E4E8\"> <\/span><span style=\"color: #9ECBFF\">systemctl<\/span><span style=\"color: #E1E4E8\"> <\/span><span style=\"color: #9ECBFF\">status<\/span><span style=\"color: #E1E4E8\"> <\/span><span style=\"color: #9ECBFF\">avahi-daemon<\/span><\/span><\/code><\/pre><\/div>\n<p>The output should display the status <code>active (running)<\/code>. The KIG 300 will now be listed in the Home Assistant web interface, and paired roof windows or roller shutters will show up as entities.<\/p>\n\n<h2>Troubleshooting<\/h2>\n<ul>\n  <li><strong>Device not discovered despite reflector:<\/strong> If the Velux app on your smartphone prompts you to complete the HomeKit setup, do not finish this process on your phone; restart Home Assistant instead. If the gateway was previously paired with HomeKit, you may need to remove it there or reset the KIG 300 using its configuration button (press and hold until the LED turns red).<\/li>\n  <li><strong>KIG 300 loses Wi-Fi connection:<\/strong> The gateway only supports 2.4 GHz Wi-Fi. Ensure that the 2.4 GHz band is active and accessible during setup.<\/li>\n<\/ul>\n\n<h2>Reverting Changes<\/h2>\n<p>To disable the reflector feature, restore the backed-up configuration file and restart the Avahi service.<\/p>\n\n<h2>Conclusion<\/h2>\n<p>Using Avahi&#8217;s reflector functionality allows you to bridge VLAN boundaries for the Velux KIG 300 HomeKit integration without sacrificing network isolation. Once paired, your Velux devices are available in Home Assistant for dashboards and automations.<\/p>\n<p><em>Sources: <a href=\"https:\/\/community.simon42.com\/t\/velux-kig-300-app-control-mit-homekit-mdns-und-avahi-installationsbericht\/2223\" rel=\"nofollow noopener\" target=\"_blank\">Forum: Simon42 &#8211; Forum<\/a>, <a href=\"https:\/\/community.home-assistant.io\/t\/integrating-velux-active-kig-300-into-home-assistant\/606661\" rel=\"nofollow noopener\" target=\"_blank\">community.home-assistant.io<\/a>, <a href=\"https:\/\/community.simon42.com\/t\/velux-kig-300-app-control-mit-homekit-mdns-und-avahi-installationsbericht\/2223\" rel=\"nofollow noopener\" target=\"_blank\">community.simon42.com<\/a><\/em><\/p><div id=\"netgu-3795137097\" class=\"netgu-after-content netgu-entity-placement\"><script async src=\"\/\/pagead2.googlesyndication.com\/pagead\/js\/adsbygoogle.js?client=ca-pub-6258556257245998\" crossorigin=\"anonymous\"><\/script><ins class=\"adsbygoogle\" style=\"display:block;\" data-ad-client=\"ca-pub-6258556257245998\" \ndata-ad-slot=\"4559785002\" \ndata-ad-format=\"auto\"><\/ins>\n<script> \n(adsbygoogle = window.adsbygoogle || []).push({}); \n<\/script>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>Is Home Assistant failing to discover the Velux KIG 300 gateway in a separate IoT VLAN? Here is how an Avahi reflector configuration solves the connection issue.<\/p>\n","protected":false},"author":1,"featured_media":26901,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[15],"tags":[3997,3770,4002,3837,3996,4000],"class_list":["post-26904","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized-en","tag-avahi-en","tag-home-assistant-en","tag-homekit-en","tag-mdns-en","tag-velux-en","tag-vlan-en"],"uagb_featured_image_src":{"full":["https:\/\/netguide.io\/smart-home\/wp-content\/uploads\/sites\/3\/2026\/09\/velux-kig-300-im-iot-vlan-uber-avahi-in-home-assistant-einbinden-editorial-editorial-62790-utm_campaignindexutm_contentthumbnail.png",1280,1280,false],"thumbnail":["https:\/\/netguide.io\/smart-home\/wp-content\/uploads\/sites\/3\/2026\/09\/velux-kig-300-im-iot-vlan-uber-avahi-in-home-assistant-einbinden-editorial-editorial-62790-utm_campaignindexutm_contentthumbnail-150x150.png",150,150,true],"medium":["https:\/\/netguide.io\/smart-home\/wp-content\/uploads\/sites\/3\/2026\/09\/velux-kig-300-im-iot-vlan-uber-avahi-in-home-assistant-einbinden-editorial-editorial-62790-utm_campaignindexutm_contentthumbnail-300x300.png",300,300,true],"medium_large":["https:\/\/netguide.io\/smart-home\/wp-content\/uploads\/sites\/3\/2026\/09\/velux-kig-300-im-iot-vlan-uber-avahi-in-home-assistant-einbinden-editorial-editorial-62790-utm_campaignindexutm_contentthumbnail-768x768.png",768,768,true],"large":["https:\/\/netguide.io\/smart-home\/wp-content\/uploads\/sites\/3\/2026\/09\/velux-kig-300-im-iot-vlan-uber-avahi-in-home-assistant-einbinden-editorial-editorial-62790-utm_campaignindexutm_contentthumbnail-1024x1024.png",1024,1024,true],"1536x1536":["https:\/\/netguide.io\/smart-home\/wp-content\/uploads\/sites\/3\/2026\/09\/velux-kig-300-im-iot-vlan-uber-avahi-in-home-assistant-einbinden-editorial-editorial-62790-utm_campaignindexutm_contentthumbnail.png",1280,1280,false],"2048x2048":["https:\/\/netguide.io\/smart-home\/wp-content\/uploads\/sites\/3\/2026\/09\/velux-kig-300-im-iot-vlan-uber-avahi-in-home-assistant-einbinden-editorial-editorial-62790-utm_campaignindexutm_contentthumbnail.png",1280,1280,false]},"uagb_author_info":{"display_name":"Tobias","author_link":"https:\/\/netguide.io\/smart-home\/author\/tobias-pries\/"},"uagb_comment_info":0,"uagb_excerpt":"Is Home Assistant failing to discover the Velux KIG 300 gateway in a separate IoT VLAN? Here is how an Avahi reflector configuration solves the connection issue.","brizy_media":[],"_links":{"self":[{"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/posts\/26904","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/comments?post=26904"}],"version-history":[{"count":1,"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/posts\/26904\/revisions"}],"predecessor-version":[{"id":26905,"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/posts\/26904\/revisions\/26905"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/media\/26901"}],"wp:attachment":[{"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/media?parent=26904"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/categories?post=26904"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/netguide.io\/smart-home\/wp-json\/wp\/v2\/tags?post=26904"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}