Home Assistant is ontzettend veelzijdig. Je kunt er verlichting, verwarming, sensoren, camera’s en allerlei andere slimme apparaten mee combineren. Maar hoe groter je installatie wordt, hoe groter de kans dat je een keer tegen een probleem aanloopt. Een apparaat is ineens niet beschikbaar, een automatisering doet niets meer of na een update lijkt een integratie verdwenen.
Je bent daarin zeker niet de enige. Op Reddit en het officiële Home Assistant Community Forum komen veel van dezelfde vragen terug. In dit artikel zetten we de meest herkenbare problemen bij elkaar. Je leest niet alleen wat je kunt proberen, maar vooral ook hoe je stap voor stap de oorzaak vindt. Dat is vaak belangrijker dan zomaar instellingen veranderen.
Goed om te weten: niet ieder probleem heeft dezelfde oorzaak. Een apparaat dat niet reageert kan bijvoorbeeld een netwerkprobleem hebben, maar ook een lege batterij, een vastgelopen integratie of een foutieve automatisering. Werk daarom rustig van eenvoudige controles naar uitgebreidere diagnose.
1. Een apparaat of entiteit staat op ‘Unavailable’
Een van de meest herkenbare meldingen in Home Assistant is unavailable. Je ziet dit bijvoorbeeld bij een temperatuursensor, slimme stekker, lamp of integratie. De entiteit bestaat nog wel, maar Home Assistant ontvangt op dat moment geen bruikbare status van de bron.
Mogelijke oorzaken
- Het apparaat heeft geen stroom of de batterij is leeg.
- De wifi- of ethernetverbinding is weggevallen.
- Een Zigbee-apparaat heeft geen goede verbinding met het mesh-netwerk.
- De integratie kan de externe dienst of het apparaat niet bereiken.
- De fabrikantendienst of API is tijdelijk niet bereikbaar.
- De entiteit is hernoemd, verwijderd of door een wijziging niet meer beschikbaar.
Zo onderzoek je het probleem
- Open Instellingen > Apparaten en diensten en zoek de betreffende integratie.
- Open het apparaat en controleer of andere entiteiten van hetzelfde apparaat ook niet beschikbaar zijn.
- Controleer de voeding, batterij en netwerkverbinding van het apparaat.
- Bekijk Instellingen > Systeem > Logboeken en filter indien mogelijk op de betreffende integratie.
- Controleer bij Zigbee of het apparaat nog in Zigbee2MQTT of ZHA zichtbaar is.
Is alleen één entiteit niet beschikbaar, terwijl de rest van het apparaat werkt? Dan kan het probleem ook bij die specifieke sensor of functie liggen. Is een hele groep apparaten tegelijk weg, kijk dan eerst naar de integratie, coordinator, broker of netwerkverbinding die ze gemeenschappelijk gebruiken.
Tip voor automatiseringen: houd rekening met de toestanden unknown en unavailable. Een sensor kan tijdelijk zijn verbinding verliezen en daarna weer terugkomen. Als je automatisering op iedere statuswijziging reageert, kan dat onverwachte acties veroorzaken. Gebruik waar passend een expliciete begin- en eindtoestand in je trigger en controleer de trace om te zien welke statusovergang de automatisering heeft gestart.
Meer hierover wordt besproken in het Home Assistant Community Forum.
2. Een automatisering wordt niet uitgevoerd
Je hebt een automatisering gemaakt die bijvoorbeeld de verlichting moet inschakelen zodra je thuiskomt. Toch gebeurt er niets. Dit is frustrerend, zeker wanneer de automatisering eerder wel goed werkte.
Een automatisering bestaat uit drie belangrijke onderdelen: een trigger die de automatisering start, eventuele voorwaarden die moeten kloppen en acties die vervolgens worden uitgevoerd. Als één onderdeel niet klopt, kan het lijken alsof de hele automatisering niets doet.
Controleer de trace
De trace (uitvoeringsspoor) is meestal de beste plek om te beginnen. Open Instellingen > Automatiseringen en scènes, selecteer de automatisering en open de traces. Je ziet daar welke stappen zijn uitgevoerd en waar de uitvoering eventueel is gestopt.
- Geen trace: de trigger is mogelijk nooit geactiveerd, of de automatisering is uitgeschakeld.
- Trigger uitgevoerd, voorwaarde niet gehaald: controleer de voorwaarden en de actuele waarden van sensoren, personen of tijden.
- Actie mislukt: controleer of het doelapparaat en de gebruikte entiteit nog bestaan en beschikbaar zijn.
- Onverwachte herhaling: controleer of een sensor tijdelijk naar
unknownofunavailablegaat.
Je kunt een actie ook handmatig uitvoeren vanuit de automatisering. Werkt de actie dan wel, maar wordt de automatisering niet gestart? Richt je onderzoek dan op de trigger en voorwaarden. Werkt de actie ook handmatig niet, onderzoek dan de doelentiteit of service.
Lees ook de officiële uitleg: Troubleshooting automations.
3. Een automatisering of script is ineens niet beschikbaar
Soms verschijnt bij een automatisering de status unavailable, of wordt een automatisering na een wijziging niet meer geladen. Een veelvoorkomende oorzaak is een verwijzing naar een apparaat of entiteit die niet meer bestaat of waarvan de entity-ID is veranderd.
Open de automatisering in de visuele editor en controleer de triggers, voorwaarden en acties. Kijk vooral naar entiteiten die je onlangs hebt verwijderd, opnieuw hebt gekoppeld of een andere naam hebt gegeven. Controleer ook de YAML wanneer de editor een foutmelding geeft.
Gebruik je YAML? Controleer dan de configuratie op syntaxfouten en let op inspringing. YAML is gevoelig voor spaties. Eén verkeerd ingesprongen regel kan ervoor zorgen dat een onderdeel niet wordt geladen.
4. Zigbee-apparaten vallen regelmatig weg
Ook Zigbee-problemen komen veel terug in communitydiscussies. Een sensor reageert traag, een lamp verdwijnt tijdelijk of een batterijapparaat lijkt niet meer te communiceren. Zigbee werkt met een mesh-netwerk: apparaten die als router functioneren kunnen berichten van andere apparaten doorgeven.
Wat kun je controleren?
- Controleer of de Zigbee-coordinator nog verbonden is met Home Assistant of Zigbee2MQTT.
- Bekijk de logboeken van ZHA of Zigbee2MQTT op verbindingsfouten.
- Controleer of routers (meestal apparaten op netvoeding) nog stroom hebben.
- Plaats de coordinator met een USB-verlengkabel wat verder van de server en USB 3-apparatuur.
- Controleer of het Zigbee-kanaal storingen ondervindt van je wifi-netwerk.
- Vervang een lege batterij en geef een batterijapparaat zo nodig tijd om opnieuw contact te maken.
Verwijder een apparaat niet direct uit je Zigbee-netwerk. Daarmee kun je de bestaande koppeling kwijtraken en moet je het apparaat opnieuw pairen. Onderzoek eerst of het probleem bij één apparaat, een router of de coordinator zit.
Op het officiële forum staat een aparte Zigbee-categorie met veel discussies over bereik, coordinators, routers en apparaten die niet goed reageren. Op HomeAssistantTips.nl vind je ook onze Zigbee-beginnershandleiding en de uitleg over Zigbee2MQTT.
5. Een integratie werkt niet meer of vraagt opnieuw om inloggen
Een integratie kan stoppen met werken doordat een wachtwoord is gewijzigd, een toegangstoken is verlopen, de fabrikant zijn API heeft aangepast of een externe dienst tijdelijk niet beschikbaar is. Dit zie je vooral bij cloudintegraties en community-integraties.
Open de integratie onder Instellingen > Apparaten en diensten. Kijk of Home Assistant een reparatiemelding of herauthenticatie aanbiedt. Controleer daarnaast de logboeken en de documentatie van de integratie. Bij een community-integratie is ook de projectpagina of GitHub-repository belangrijk: daar kan de ontwikkelaar melden dat een API is gewijzigd of dat een nieuwe versie nodig is.
Verwijder de integratie niet meteen. Als je haar verwijdert en opnieuw toevoegt, kunnen bestaande apparaten, entiteiten of instellingen veranderen. Probeer eerst opnieuw in te loggen of de aangeboden reparatie uit te voeren. Maak bij twijfel vooraf een back-up.
Zie ook onze handleiding Inloggegevens gewijzigd van een integratie.
6. Home Assistant wordt traag of de database groeit enorm
Na verloop van tijd kan de database van Home Assistant behoorlijk groeien. De Recorder bewaart historische gegevens van entiteiten. Sensoren die iedere paar seconden een nieuwe waarde doorgeven, kunnen veel records opleveren. Een grote database kan onderhoud, back-ups en het openen van geschiedenisweergaven vertragen.
Zo beperk je onnodige databasegroei
- Controleer de databasegrootte via Instellingen > Systeem > Reparaties en open via het menu de systeeminformatie.
- Controleer welke sensoren heel vaak veranderen.
- Gebruik de Recorder-instellingen om onnodige entiteiten uit te sluiten als je hun geschiedenis niet nodig hebt.
- Stel een bewaartermijn in die past bij je gebruik en beschikbare opslag.
- Gebruik bij voorkeur betrouwbare SSD-opslag in plaats van een goedkope of versleten SD-kaart.
Schakel niet zomaar alle sensoren uit. Historische gegevens kunnen belangrijk zijn voor energieoverzichten, statistieken en grafieken. Kies bewust welke gegevens je wilt bewaren. De officiële documentatie over Recorder en back-ups helpt je hierbij.
Op het Community Forum staat bovendien een uitgebreide discussie over het beheersen van de Recorder-database.
7. Een back-up mislukt
Een mislukte back-up is iets om serieus te nemen. Een veelvoorkomende melding bij de standaard SQLite-database is Could not lock database within 30 seconds. Home Assistant moet de database tijdelijk voorbereiden voordat de back-up kan worden gemaakt. Als dat te lang duurt, kan de back-up mislukken.
Controleer eerst de logboeken. Kijk bij Home Assistant OS ook naar de Supervisor-logboeken, omdat de Supervisor het back-upproces beheert. Een grote database, intensieve Recorder-onderhoudswerkzaamheden of trage opslag kunnen een rol spelen.
Praktische stappen:
- Probeer de back-up later nogmaals te maken.
- Controleer of er voldoende vrije opslagruimte is.
- Controleer de grootte van de Recorder-database.
- Verplaats een geplande back-up eventueel naar een rustiger tijdstip.
- Controleer of de externe back-uplocatie bereikbaar is en voldoende ruimte heeft.
- Controleer of apps en externe databases afzonderlijk moeten worden meegenomen in je back-upstrategie.
Bewaar back-ups niet alleen op dezelfde schijf als Home Assistant. Als die schijf defect raakt, ben je mogelijk zowel je installatie als je back-ups kwijt. Gebruik bijvoorbeeld een NAS of een andere externe opslaglocatie en test af en toe of een herstel daadwerkelijk lukt.
De officiële documentatie beschrijft ook specifieke problemen zoals een database die niet kan worden vergrendeld, een volle opslaglocatie en een back-up die niet alle apps bevat: Home Assistant Backups.
8. Home Assistant start niet goed op na een update of YAML-wijziging
Heb je een YAML-bestand aangepast of een update uitgevoerd en kom je daarna in Recovery Mode terecht? Dan kan Home Assistant een configuratiefout hebben gevonden waardoor de normale configuratie niet veilig kan worden geladen.
Ga naar Instellingen > Systeem > Logboeken en zoek naar de eerste foutmelding die bij het opstarten is ontstaan. Vaak staat daarin welk bestand en welke regel het probleem veroorzaakt. Controleer vooral recente wijzigingen in configuration.yaml, templates, scripts en automatiseringen.
Herstel de fout en start Home Assistant opnieuw. Weet je niet wat je moet aanpassen? Zet dan de laatste wijziging terug of herstel een back-up van vóór het probleem. Recovery Mode is juist bedoeld om je toegang te geven tot de omgeving terwijl je de oorzaak onderzoekt.
Lees de officiële uitleg: General troubleshooting.
9. Apparaten worden niet automatisch gevonden
Je sluit een nieuw apparaat aan, maar Home Assistant toont geen melding om het toe te voegen. Dat betekent niet automatisch dat het apparaat niet wordt ondersteund. Automatische ontdekking is afhankelijk van het gebruikte protocol, de integratie en je netwerk.
- Controleer of het apparaat en Home Assistant zich op hetzelfde netwerk bevinden, als de integratie dat vereist.
- Controleer VLAN’s, firewallregels en multicast/mDNS wanneer apparaten via netwerkdetectie worden gevonden.
- Zoek de integratie handmatig via Instellingen > Apparaten en diensten > Integratie toevoegen.
- Controleer of het apparaat eerst in de app van de fabrikant moet worden ingesteld.
- Controleer of het apparaat het protocol gebruikt dat je verwacht, bijvoorbeeld wifi, Zigbee, Matter of Bluetooth.
Let op: zet niet zomaar je hele firewall open om detectie te laten werken. Zoek eerst uit welk protocol en welke netwerkpoorten of multicast-functies de betreffende integratie nodig heeft. Bij Matter en mDNS kunnen netwerksegmentatie en VLAN-instellingen extra aandacht vragen.
10. Na een update werkt iets anders dan voorheen
Home Assistant ontwikkelt zich snel. Menu’s kunnen veranderen, integraties krijgen nieuwe mogelijkheden en soms verdwijnen oude configuratiemethoden. Ook community-integraties kunnen afhankelijk zijn van wijzigingen in Home Assistant of bij de fabrikant.
Voorkom verrassingen door niet blind op iedere update te klikken. Lees de release notes, controleer eventuele breaking changes en maak vooraf een back-up. Werk bij voorkeur eerst één onderdeel bij en controleer daarna of je belangrijkste apparaten en automatiseringen nog werken.
Gebruik je een community-integratie? Controleer dan ook de release notes van die integratie. Een probleem hoeft niet door Home Assistant Core te worden veroorzaakt.
Een handig stappenplan: zo pak je ieder Home Assistant-probleem aan
Weet je niet waar je moet beginnen? Gebruik dan dit vaste stappenplan. Het voorkomt dat je allerlei instellingen tegelijk verandert en daardoor de oorspronkelijke oorzaak uit het oog verliest.
- Omschrijf het probleem: wat werkt niet, sinds wanneer en welke apparaten of entiteiten zijn betrokken?
- Controleer de basis: stroom, batterij, netwerk, IP-adres en internetverbinding.
- Controleer de integratie: is deze geladen en zijn er reparatiemeldingen?
- Bekijk de logboeken: zoek naar foutmeldingen op het moment dat het probleem optreedt.
- Controleer de trace: bij automatiseringen en scripts zie je welke stap wel of niet is uitgevoerd.
- Verander één ding tegelijk: zo kun je vaststellen welke aanpassing effect heeft.
- Maak een back-up: zeker voordat je bestanden, databases of belangrijke integraties aanpast.
- Vraag gericht hulp: deel de relevante foutmelding, je installatievorm en de stappen waarmee je het probleem kunt reproduceren.
Waar kun je hulp vragen?
Kom je er zelf niet uit? Dan zijn er verschillende plekken waar je hulp kunt vinden:
- Home Assistant Community Forum – het officiële communityforum met onderwerpen over configuratie, integraties, hardware en automatiseringen.
- Reddit – r/homeassistant – een actieve community waar gebruikers ervaringen, oplossingen en ideeën delen.
- Home Assistant Help – de officiële documentatie over hulp zoeken en problemen melden.
Wanneer je een vraag stelt, vermeld dan altijd je Home Assistant-versie, installatievorm (bijvoorbeeld Home Assistant OS, Container of een VM), de naam en versie van de integratie en de relevante logregel. Plaats geen wachtwoorden, tokens, externe IP-adressen of andere gevoelige gegevens. Controleer ook gedownloade diagnostische bestanden voordat je ze openbaar deelt.
Conclusie: rustig onderzoeken werkt beter dan lukraak aanpassen
De meeste Home Assistant-problemen zijn goed te onderzoeken als je systematisch te werk gaat. Een entiteit die niet beschikbaar is, een automatisering die niet start of een back-up die mislukt: begin met de logboeken, controleer de betrokken integratie en kijk wat er precies gebeurde op het moment van de fout.
Maak regelmatig back-ups, houd je installatie bij, lees de release notes en verander niet meerdere instellingen tegelijk. En onthoud: ook ervaren Home Assistant-gebruikers lopen tegen problemen aan. Juist door ervaringen en oplossingen te delen, wordt de community sterker.
Bronnen en verder lezen
Voor dit artikel zijn terugkerende onderwerpen uit Reddit en het Home Assistant Community Forum gebruikt. De technische controles en herstelstappen zijn waar mogelijk gebaseerd op de officiële documentatie van Home Assistant.