Home Assistant werkt niet meer diagnose stappen
Je zit lekker op de bank, wilt het licht dimmen en... Home Assistant doet niks.
De app geeft een foutmelding, de website is onbereikbaar, of je Raspberry Pi draait nog wel maar je komt er niet meer in. Paniek? Nee, hoor. Dit overkomt iedereen met een eigen smart home hub. Meestal is het iets kleins.
Laten we even samen kijken wat er aan de hand is. We gaan stap voor stap checken waar het misgaat.
Wat heb je nodig?
Voordat we beginnen, zorg dat je dit bij de hand hebt. Je hoeft geen ingewikkelde tools te kopen, want we lossen dit op met wat je al in huis hebt.
- Een laptop of computer: Die moet je gebruiken om te testen. Een telefoon werkt soms ook, maar een laptop is overzichtelijker.
- Toegang tot je router: We moeten straks even kijken welk IP-adres je Home Assistant heeft. Meestal vind je dit in de app van je internetprovider of op een stickertje op de router.
- De Home Assistant app: Zorg dat je deze op je telefoon hebt staan, bijvoorbeeld de Companion App.
- Een stopcontact in de buurt: We gaan waarschijnlijk de stroom eraf halen en er weer op doen. Handig als je erbij kunt.
- Geduld: Het duurt ongeveer 5 tot 10 minuten per stap. Haal even adem, dit komt goed.
Stap 1: De fysieke verbinding checken
Home Assistant is een stukje software dat draait op hardware. Als de hardware niet goed staat aangesloten, doet de software het ook niet. Dit is de meest voorkomende oorzaak bij een Raspberry Pi of NUC.
- Kabels controleren: Ga naar je Home Assistant apparaat (bijvoorbeeld je Raspberry Pi). Check of de ethernetkabel (de netwerkkabel) stevig in zit. Ook aan de kant van de router. Een losse kabel is vaak de boosdoener.
- Stroom checken: Controleer of de stroomadapter goed in het stopcontact zit. Trek de stroomkabel uit het apparaat en stop hem er weer in. Kijk of er een lampje brandt op de Pi of de NUC. Geen licht? Probeer even een andere stroomadapter of een ander stopcontact.
- HDMI monitor test (alleen voor Pi/NUC): Als je een scherm kunt aansluiten via HDMI, doe dat dan even. Zie je tekst verschijnen? Dan draait het systeem wel, maar is de verbinding met je netwerk misschien zoek.
Tijdsindicatie: Dit duurt maar 2 minuten.
Veelgemaakte fout: Vergeten dat een ethernetkabel twee kanten heeft.
Zit die in de router of in je huisnetwerk? Zorg dat die goed vastklikt.
Stap 2: Is het netwerk wel oké?
Home Assistant moet praten met je apparaten (slimme lampen, sensoren) en met jou via internet. Als je netwerk plat ligt, doet je hub niets. Tijdsindicatie: 3 tot 5 minuten.
Veelgemaakte fout: Verwarren van de 2.4GHz en 5GHz wifi-netwerken.
- Test je internet: Pak je telefoon en kijk of je normaal internet hebt. Kun je websites laden? Zo niet, dan ligt het aan je provider, niet aan Home Assistant.
- Check het IP-adres: Open de app van je internetprovider (zoals Ziggo, KPN, of T-Mobile) of kijk op de sticker op je router. Zoek het overzicht van verbonden apparaten. Zoek naar 'HomeAssistant' of de naam die je hebt gegeven aan je Pi. Noteer het IP-adres (iets als 192.168.1.25).
- Ping test: Op je laptop open je een Terminal (Mac/Linux) of Command Prompt (Windows). Typ
ping 192.168.1.25(gebruik het IP-adres dat je net vond). Krijg je reactie? Dan is je apparaat online.
Home Assistant draait vaak op een Pi zonder wifi-dongle, dus zit hij vast via kabel.
Zorg dat de kabel goed zit.
Stap 3: De configuratie controleren (YAML)
Als de hardware en het netwerk oké zijn, maar Home Assistant start niet op, dan zit er vaak een foutje in je configuratiebestand. Dit heet de YAML-file.
- Inloggen via File Share: Gebruik de 'Samba Add-on' (als je die hebt geïnstalleerd) of de 'File Editor' add-on. Open het bestand
configuration.yaml. - Controleer de syntax: YAML is gevoelig voor spaties. Gebruik NOOIT tabs, alleen spaties. Kijk of alle kolommen netjes onder elkaar staan. Een foutje hier zorgt dat Home Assistant niet start.
- Commentaar uit: Weet je niet welk deel fout is? Zet delen uit met een
#tekentje voor de regel. Sla op en herstart. Werkt het weer? Dan zat de fout in het uitgezette deel. - Herstart: Na elke wijziging moet je Home Assistant opnieuw opstarten. Dit doe je via 'Settings' > 'System' > 'Restart'. Doe dit niet te snel; het systeem heeft even tijd nodig.
Een typefoutje is zo gemaakt. Tijdsindicatie: 10 tot 15 minuten.
Veelgemaakte fout: Vergeten dat Home Assistant bij een foutieve configuratie vaak gewoon blijft draaien, maar de automatiseringen werken niet. Check de logs in de 'Settings' > 'System' > 'Logs' voor rode foutmeldingen.
Stap 4: De herstart (de ouderwetse manier)
Werkt niets? Dan is een simpele reboot vaak de oplossing.
- Stroom eraf: Haal de stekker uit je Home Assistant apparaat (Raspberry Pi of NUC). Wacht 10 seconden. Dit is belangrijk voor de capacitors in de voeding.
- Stroom erop: Stop de stekker er weer in. Je ziet nu waarschijnlijk lampjes knipperen.
- Wachten: Home Assistant moet opstarten. Dit duurt bij een Pi 4 ongeveer 2 tot 5 minuten. Bij een Homey Pro of andere hub gaat het sneller (1 minuut).
- Refresh browser: Ververs je browservenster of open de app opnieuw. Probeer in te loggen.
Dit lost 80% van de problemen op. Het is even wachten, maar het helpt.
Tijdsindicatie: 5 minuten wachten.
Veelgemaakte fout: Te snel weer proberen. Als je binnen 30 seconden al weer drukt, is de boot nog niet klaar. Geef het apparaat even de tijd.
Stap 5: Backup terugzetten (wanhoopsoptie)
Als Home Assistant echt niet meer wil opstarten na bovenstaande stappen, is je configuratie misschien kapot. Mocht je na deze stappen je domotica hub apparaat niet meer vinden, dan heb je gelukkig vast een backup. Een goede smart home gebruiker maakt elke week een backup.
- Haal de backup op: Ga naar de website van Home Assistant (via de cloud of lokaal als het werkt) en download de nieuwste backup. Als je helemaal vastzit, moet je soms je SD-kaart of SSD uit de Pi halen en deze inlezen op een andere computer.
- Herstel de installatie: Als je een nieuwe installatie hebt gedaan (bijvoorbeeld na een kapotte SD-kaart), kies dan bij het opstarten voor 'Restore from backup'.
- Uploaden: Upload het backup-bestand. Dit duurt even, afhankelijk van de grootte (meestal 50MB - 500MB).
- Wacht op synchronisatie: Na de restore moet Home Assistant alle devices weer herkennen. Dit kan 10 minuten duren.
Tijdsindicatie: 15 tot 30 minuten.
Veelgemaakte fout: Een backup terugzetten die ouder is dan een maand.
Dan mis je de nieuwste aanpassingen aan je slimme lampen of sensoren.
Stap 6: Community hulp inschakelen
Het kan zijn dat je echt vastloopt. Dan is het tijd om hulp te vragen.
- Zoek de forum: Ga naar het Home Assistant Community Forum (via je telefoon als je laptop het niet doet).
- Zoek je foutmelding: Kopieer de exacte foutmelding uit de logs (zie stap 3) en plak deze in de zoekbalk. Grote kans dat iemand anders dit al heeft opgelost.
- Vraag om hulp: Maak een account aan en post je vraag. Zet erbij wat voor hardware je gebruikt (Raspberry Pi 4, Home Assistant Yellow) en wat je al hebt geprobeerd.
- Check Discord: Er is een Home Assistant Discord server waar je live kunt chatten met experts. Dit is vaak sneller dan een forum.
De Home Assistant community is enorm behulpzaam. Tijdsindicatie: 20 minuten tot een uur.
Veelgemaakte fout: Te weinig informatie geven. Zeg niet alleen "het werkt niet", maar vertel welke stappen je hebt gedaan en wat de logs zeggen.
Verificatie-checklist
Is alles weer aan het draaien? Mocht je specifiek een Homey Pro verbinding herstellen, loop dan deze lijst even na om zeker te weten dat je smart home weer stabiel is.
- Website bereikbaar: Kun je inloggen via de webinterface op je laptop?
- App verbonden: Werkt de Home Assistant app op je telefoon, ook als je niet op je thuis-wifi zit?
- Sensoren actief: Zie je data binnenkomen van je temperatuursensoren, bewegingsmelders of rookmelders?
- Automatiseringen draaien: Test een simpele actie. Zet een lamp aan via een schakelaar of tijdsschema. Doet ie het?
- Integraties groen: Kijk in 'Settings' > 'Devices & Services'. Staan je Hue, Ikea Tradfri, of Z-Wave stick op groen (gekoppeld)?
- Geen foutmeldingen: Check de logs nog een keer. Zijn er geen rode regels meer?
Als je overal 'Ja' kunt antwoorden, ben je klaar. Je hebt je eigen smart home hub gered en eventuele opslagproblemen met de SD-kaart definitief verholpen.
Dat is het voordeel van zelf hosten: je bent de baas en je kunt het altijd fixen.