Na een update kan een Home Assistant-integratie plotseling niet meer werken. Apparaten worden unavailable, gegevens verversen niet of je krijgt een foutmelding bij het laden. Dat betekent niet automatisch dat Home Assistant zelf defect is. De oorzaak kan ook liggen bij gewijzigde authenticatie, een API-wijziging of een community-integratie die nog niet compatibel is.
1. Stel vast wat er is bijgewerkt
Noteer of het probleem begon na een Core-, OS-, App- of integratie-update. Deze onderdelen hebben verschillende functies. Controleer de release notes en kijk of er bekende problemen of gewijzigde vereisten worden genoemd. Verander niet meteen meerdere onderdelen tegelijk.
2. Controleer de integratie en entiteiten
Open Instellingen > Apparaten en diensten en selecteer de integratie. Kijk of er een herstelmelding staat en of apparaten of entiteiten nog worden aangemaakt. Controleer via Ontwikkelaarstools of entiteiten bestaan en welke status ze hebben. Een hernoemde of verwijderde entiteit kan ook bestaande dashboards en automatiseringen beïnvloeden.
3. Bekijk de logboeken
Open Instellingen > Systeem > Logboeken en zoek naar meldingen van de betreffende integratie. Let op termen zoals authentication failed, timeout, connection refused, rate limit of setup failed. De foutmelding helpt bepalen of het probleem bij inloggen, netwerk, API of configuratie zit.
4. Gebruik tijdelijk debuglogging
Via de integratiepagina kun je voor ondersteunde integraties debuglogging inschakelen. Reproduceer het probleem en schakel debuglogging daarna weer uit. De uitgebreide logs kunnen veel gegevens produceren. Controleer ze op tokens, e-mailadressen, IP-adressen of andere privégegevens voordat je ze deelt.
5. Controleer authenticatie en API-limieten
Cloudintegraties kunnen stoppen wanneer een wachtwoord is gewijzigd, een token is verlopen, tweestapsverificatie is aangepast of de fabrikant de API heeft veranderd. Meld je indien nodig opnieuw aan via de integratieopties. Krijg je HTTP 429 of een melding over te veel verzoeken, dan kan de dienst tijdelijk een limiet hebben opgelegd. Herhaaldelijk opnieuw laden kan het probleem verergeren; wacht en controleer de documentatie of status van de dienst.
6. Officiële of community-integratie?
Home Assistant bevat officiële integraties, maar ook communityprojecten. Bij een community-integratie ben je afhankelijk van de ontwikkelaar en eventuele API-wijzigingen van de fabrikant. Controleer de repository, releasegeschiedenis en openstaande issues. Een update van Home Assistant kan een incompatibiliteit zichtbaar maken die al langer bestond.
7. Herstellen of teruggaan naar een vorige versie
Maak eerst een back-up. Als het probleem direct na een update is ontstaan en er een bekende incompatibiliteit is, kan herstel naar een eerdere toestand tijdelijk helpen. Doe dit alleen met een passende back-up en begrijp welke onderdelen worden overschreven. Een downgrade is geen structurele oplossing wanneer de integratie afhankelijk is van een gewijzigde externe API.
8. Wanneer opnieuw configureren?
Verwijder een integratie niet als eerste stap. Daarmee kun je instellingen, apparaatkoppelingen en entiteitsrelaties verliezen. Probeer eerst herladen, opnieuw authenticeren of de officiële herstelstappen. Verwijder en voeg pas opnieuw toe wanneer de documentatie dat adviseert of wanneer je weet wat opnieuw aangemaakt moet worden.
Stappenplan
- Noteer welke update vlak voor het probleem is uitgevoerd.
- Controleer de integratiepagina en herstelmeldingen.
- Bekijk entiteitsstatussen en systeemlogs.
- Schakel indien nodig tijdelijk debuglogging in.
- Controleer authenticatie, tokens, API-status en limieten.
- Controleer compatibiliteit en bekende issues.
- Maak een back-up voordat je herstel of herinstallatie uitvoert.
Veelgestelde vragen
Moet ik Home Assistant opnieuw installeren?
Meestal niet. Begin met logs, integratie-instellingen, authenticatie en compatibiliteit. Een volledige herinstallatie is zelden de eerste diagnose.
Waarom werkt de integratie na opnieuw inloggen nog steeds niet?
De oorzaak kan ook een API-storing, limiet, netwerkprobleem of incompatibele integratieversie zijn. Bekijk de concrete foutmelding.
Conclusie
Een integratie die na een update stopt, vraagt om een gerichte diagnose. Stel vast wat er veranderde, bekijk de logs en controleer authenticatie en compatibiliteit. Zo voorkom je dat je een werkende installatie onnodig opnieuw opbouwt.