Nach einem Home-Assistant-Update funktioniert plötzlich die Overkiz-Integration nicht mehr. Genau das ist mir passiert: Die Somfy-Jalousien und Lichter waren nicht mehr erreichbar, in der Oberfläche nur noch Fragezeichen. Im Video gehe ich die Fehlersuche Schritt für Schritt durch, hier das Vorgehen zum Nachlesen.
Fehlerbild und erste Schritte
Wenn Geräte aus der Overkiz-Integration nach einem Update nicht mehr erreichbar sind, siehst du das meist an Symbolen mit Fragezeichen. Ein Neustart der Integration oder des ganzen Systems bringt in diesen Fällen oft nichts. Die Ursache sitzt tiefer, entweder in der Integration selbst oder in einer geänderten Schnittstelle der angebundenen Hardware.
Der erste sinnvolle Schritt: ein Blick in die Dokumentation und die bekannten Fehlerquellen. Die Overkiz-Integration, die unter anderem Somfy-Geräte unterstützt, ist ein Open-Source-Projekt. Im GitHub-Repository findest du nicht nur die technischen Details, sondern auch die Issues mit bekannten Problemen.
GitHub-Issues als Werkzeug für die Fehlersuche
In den Issues dokumentieren Nutzer und Entwickler aktuelle Fehlerbilder, oft inklusive Hinweisen auf die Ursache, etwa Zertifikatsprobleme oder API-Änderungen. In meinem Fall fand sich nach dem Update zum Beispiel der gemeldete Fehler „local API cannot connect certificate verify failed". Solche Einträge zeigen dir: Du bist nicht allein, und meist arbeitet schon jemand an einer Lösung.
Gleiche deine Fehlerbeschreibung mit den bestehenden Issues ab. Oft findest du dort temporäre Workarounds oder Hinweise, wie sich das Problem eingrenzen lässt. Auch die README des Overkiz-Repositorys liefert technische Hintergründe und Konfigurationshinweise. Grundlagen dazu, wie Integrationen in Home Assistant funktionieren, findest du im Integrationen-Guide.
