Deprecate velux reboot action (home-assistant#155549)

Co-authored-by: Joost Lekkerkerker <[email protected]>

Author: wollew

homeassistant/components/velux/__init__.py

@@ -7,7 +7,7 @@
 from homeassistant.config_entries import ConfigEntry
 from homeassistant.const import CONF_HOST, CONF_PASSWORD, EVENT_HOMEASSISTANT_STOP
 from homeassistant.core import HomeAssistant, ServiceCall
-from homeassistant.helpers import device_registry as dr
+from homeassistant.helpers import device_registry as dr, issue_registry as ir
 
 from .const import DOMAIN, LOGGER, PLATFORMS
 
@@ -51,6 +51,18 @@ async def on_hass_stop(event):
         await pyvlx.disconnect()
 
     async def async_reboot_gateway(service_call: ServiceCall) -> None:
+        """Reboot the gateway (deprecated - use button entity instead)."""
+        ir.async_create_issue(
+            hass,
+            DOMAIN,
+            "deprecated_reboot_service",
+            is_fixable=False,
+            issue_domain=DOMAIN,
+            severity=ir.IssueSeverity.WARNING,
+            translation_key="deprecated_reboot_service",
+            breaks_in_ha_version="2026.6.0",
+        )
+
         await pyvlx.reboot_gateway()
 
     entry.async_on_unload(

homeassistant/components/velux/strings.json

@@ -41,6 +41,12 @@
       "message": "Failed to reboot gateway. Try again in a few moments or power cycle the device manually"
     }
   },
+  "issues": {
+    "deprecated_reboot_service": {
+      "description": "The `velux.reboot_gateway` service is deprecated and will be removed in Home Assistant 2026.6.0. Please use the 'Restart' button entity instead. You can find this button in the device page for your KLF 200 Gateway or by searching for 'restart' in your entity list.",
+      "title": "Velux reboot service is deprecated"
+    }
+  },
   "services": {
     "reboot_gateway": {
       "description": "Reboots the KLF200 Gateway",