Home Assistant installeren
In het vorige hoofdstuk hebben we bepaald welke hardware en installatiemethode we gebruiken. Nu gaan we Home Assistant daadwerkelijk installeren.
In het vorige hoofdstuk hebben we bepaald welke hardware en installatiemethode we gebruiken.
Nu gaan we Home Assistant daadwerkelijk installeren.
De exacte eerste stappen zijn afhankelijk van het gekozen apparaat. Home Assistant Green is al voorbereid en hoeft alleen te worden aangesloten. Bij een Raspberry Pi of mini-pc moeten we Home Assistant OS eerst op de juiste opslag installeren.
Daarna komen alle routes weer bij elkaar.
Zodra Home Assistant bereikbaar is, doorlopen we in de browser dezelfde eerste configuratie. We maken een beheerdersaccount, stellen de locatie en tijdzone in en controleren of Home Assistant betrouwbaar opnieuw opstart.
Neem voor dit hoofdstuk rustig de tijd.
Het schrijven van een installatie-image kan bestaande gegevens op een geheugenkaart of schijf volledig verwijderen. Controleer daarom vóór iedere stap welk opslagapparaat je hebt geselecteerd.
Wat we gaan installeren
We installeren Home Assistant Operating System, meestal afgekort tot Home Assistant OS.
Home Assistant OS is een speciaal besturingssysteem dat is ontworpen om Home Assistant en de bijbehorende onderdelen te draaien.
Het bevat onder andere:
- het besturingssysteem;
- Home Assistant Core;
- de beheeromgeving voor updates en back-ups;
- ondersteuning voor apps;
- functies voor systeemherstel en diagnose.
Je hoeft dus niet eerst Windows of een gewone Linux-distributie te installeren.
Bij Home Assistant Green is Home Assistant OS al aanwezig. Bij een Raspberry Pi of mini-pc schrijven we een Home Assistant OS-image naar de opslag.
Een image is een compleet beeld van een schijf. Het bevat niet alleen losse installatiebestanden, maar ook de indeling en gegevens die nodig zijn om het apparaat op te starten.
Daarom kun je het imagebestand niet simpelweg naar een geheugenkaart of SSD kopiëren. We gebruiken speciale software die het image correct naar de opslag schrijft.
Eerst bepalen welke route je volgt
Gebruik alleen de route die bij jouw hardware hoort:
- Route A — Home Assistant Green: aansluiten en opstarten;
- Route B — Raspberry Pi: Home Assistant OS met Raspberry Pi Imager naar de opslag schrijven;
- Route C — mini-pc: Home Assistant OS naar de interne schijf schrijven en de computer daarvan laten opstarten.
Na het onderdeel Home Assistant voor het eerst openen zijn de stappen voor iedereen grotendeels hetzelfde.
Lees niet alle installatiestappen door elkaar terwijl je bezig bent. Dat voorkomt dat je per ongeluk een handeling voor andere hardware uitvoert.
Voor je begint: maak een back-up
Wanneer je Home Assistant OS op een geheugenkaart of schijf schrijft, worden de bestaande gegevens op die opslag overschreven.
Gebruik daarom geen opslag waarop nog belangrijke bestanden staan.
Bij een mini-pc kan het installeren van Home Assistant OS het bestaande besturingssysteem, persoonlijke bestanden en herstelpartities verwijderen.
Controleer vooraf:
- of je de juiste computer gebruikt;
- of de gekozen schijf volledig voor Home Assistant mag worden gebruikt;
- of belangrijke bestanden elders zijn opgeslagen;
- of een eventueel bestaand besturingssysteem mag worden verwijderd;
- of je weet welke schijf de interne systeemschijf is.
Twijfel je of er nog belangrijke gegevens aanwezig zijn? Stop dan en controleer dit eerst.
Een verkeerde schijf selecteren is achteraf niet eenvoudig ongedaan te maken.
Route A — Home Assistant Green aansluiten
Home Assistant Green wordt geleverd met Home Assistant OS. Je hoeft daarom geen image te downloaden of opslag voor te bereiden.
Controleer of je hebt:
- Home Assistant Green;
- de meegeleverde voeding;
- een werkende netwerkkabel;
- een vrije netwerkaansluiting op je router of netwerkswitch;
- een internetverbinding;
- een computer of telefoon op hetzelfde netwerk.
Stap 1 — Kies een geschikte plaats
Plaats Home Assistant Green op een droge en goed geventileerde plek.
Zorg dat:
- het apparaat niet wordt afgedekt;
- de netwerkkabel zonder spanning kan worden aangesloten;
- de voedingskabel niet gemakkelijk wordt losgetrokken;
- je later bij de USB-aansluitingen kunt;
- het apparaat niet naast een sterke warmtebron staat.
Plaats hem bij voorkeur in de buurt van je router of netwerkswitch.
Gebruik nog geen aanvullende USB-adapters. Eerst controleren we of de basisinstallatie betrouwbaar werkt.
Stap 2 — Sluit de netwerkkabel aan
Verbind Home Assistant Green met een netwerkkabel aan je router of switch.
Doe dit voordat je de voeding aansluit.
De netwerkkabel zorgt ervoor dat Home Assistant:
- een IP-adres van de router ontvangt;
- de benodigde onderdelen kan downloaden;
- vanaf je computer bereikbaar wordt;
- automatisch naar apparaten op het lokale netwerk kan zoeken.
Controleer of beide stekkers duidelijk vastklikken.
Stap 3 — Sluit de voeding aan
Sluit de meegeleverde voeding aan op Home Assistant Green en steek daarna de adapter in het stopcontact.
Het apparaat start automatisch.
Tijdens de eerste start wordt de omgeving voorbereid. Dit kan enige tijd duren. Onderbreek de voeding niet omdat er niet direct een webpagina verschijnt.
Kijk naar de statuslampjes, maar trek daar niet te snel conclusies uit. Een brandend lampje bewijst alleen dat een deel van het apparaat voeding ontvangt. Het bewijst nog niet dat Home Assistant volledig is opgestart.
Ga nu verder bij Home Assistant voor het eerst openen.
Route B — Home Assistant OS op een Raspberry Pi installeren
Voor een Raspberry Pi gebruiken we Raspberry Pi Imager.
Dit programma schrijft het juiste Home Assistant OS-image naar de geheugenkaart.
Voor deze route heb je nodig:
- een ondersteunde Raspberry Pi;
- een passende en betrouwbare voeding;
- een geschikte microSD-kaart of andere ondersteunde opslag;
- een kaartlezer;
- een netwerkkabel;
- een computer met internettoegang.
Gebruik bij voorkeur een betrouwbare kaart met voldoende opslagruimte. Controleer altijd de actuele hardware-eisen voor jouw Raspberry Pi-model.
Stap 1 — Raspberry Pi Imager installeren
Download Raspberry Pi Imager via de officiële website van Raspberry Pi.
Installeer het programma op je computer en start het.
Afhankelijk van je besturingssysteem kan toestemming worden gevraagd om opslagapparaten te benaderen. Die toestemming is nodig omdat het programma rechtstreeks naar de geheugenkaart schrijft.
Stap 2 — Plaats de geheugenkaart
Plaats de microSD-kaart in de kaartlezer van je computer.
Wanneer de kaart eerder is gebruikt, kan je computer vragen of je de kaart wilt formatteren of herstellen.
Doe dat niet zomaar.
Raspberry Pi Imager zal de opslag tijdens het schrijven zelf opnieuw indelen. Sluit eventuele automatische meldingen en ga terug naar Raspberry Pi Imager.
Stap 3 — Kies het juiste apparaat
Selecteer in Raspberry Pi Imager het Raspberry Pi-model dat je gebruikt.
Controleer dit zorgvuldig.
Een image voor een ander model kan ervoor zorgen dat de Raspberry Pi niet opstart.
Kijk bij twijfel naar de opdruk op het bord of de verpakking.
Stap 4 — Kies Home Assistant OS
Open de keuze voor het besturingssysteem.
Kies vervolgens de categorie voor specifieke toepassingen of domotica en selecteer Home Assistant.
Selecteer daarna de Home Assistant OS-versie die bij jouw Raspberry Pi-model hoort.
De exacte namen en plaats van deze keuzes kunnen veranderen wanneer Raspberry Pi Imager wordt bijgewerkt. Controleer daarom vooral of je uiteindelijk ziet:
- Home Assistant OS;
- het juiste Raspberry Pi-model;
- de juiste opslag.
Stap 5 — Kies de opslag
Selecteer de microSD-kaart waarop Home Assistant OS moet worden geschreven.
Dit is het belangrijkste controlemoment.
Raspberry Pi Imager zal de geselecteerde opslag volledig overschrijven.
Controleer:
- de naam van de opslag;
- de capaciteit;
- of het werkelijk de losse geheugenkaart is;
- of er geen belangrijke bestanden op staan;
- of je niet per ongeluk een externe back-upschijf hebt geselecteerd.
Wanneer meerdere externe schijven zijn aangesloten, kun je die het beste tijdelijk verwijderen. Daarmee verklein je de kans op een verkeerde keuze.
Stap 6 — Schrijf Home Assistant OS
Start het schrijfproces en bevestig dat de inhoud van de kaart mag worden verwijderd.
Raspberry Pi Imager downloadt het juiste image en schrijft dit naar de kaart. Daarna wordt de geschreven inhoud meestal gecontroleerd.
Wacht tot zowel het schrijven als de controle volledig zijn afgerond.
Verwijder de kaart niet tijdens dit proces.
Wanneer een fout wordt gemeld:
- verwijder en plaats de kaart opnieuw;
- controleer de kaartlezer;
- probeer eventueel een andere USB-aansluiting;
- start Raspberry Pi Imager opnieuw;
- gebruik bij herhaalde fouten een andere geheugenkaart.
Een schrijfproces dat zonder foutmelding eindigt, bewijst nog niet dat de Raspberry Pi straks volledig zal starten. Het geeft wel aan dat de eerste controle is geslaagd.
Stap 7 — Verwijder de geheugenkaart veilig
Sluit Raspberry Pi Imager af en werp de geheugenkaart veilig uit via je besturingssysteem.
Plaats de kaart daarna in de Raspberry Pi.
Forceer de kaart niet. Controleer de richting wanneer hij niet gemakkelijk in de aansluiting past.
Stap 8 — Sluit het netwerk aan
Verbind de Raspberry Pi met een netwerkkabel aan je router of switch.
Gebruik voor de eerste installatie geen WiFi als dat niet noodzakelijk is. Een bekabelde verbinding maakt de installatie betrouwbaarder en eenvoudiger te onderzoeken.
Stap 9 — Sluit de voeding aan
Sluit als laatste de passende voeding aan.
De Raspberry Pi start automatisch en leest Home Assistant OS vanaf de geheugenkaart.
Tijdens de eerste start worden aanvullende onderdelen voorbereid en gedownload. Onderbreek de voeding niet.
Ga nu verder bij Home Assistant voor het eerst openen.
Route C — Home Assistant OS op een mini-pc installeren
Bij een mini-pc installeren we Home Assistant OS op de interne SSD of harde schijf.
Dit betekent meestal dat het bestaande besturingssysteem en alle aanwezige bestanden worden verwijderd.
Deze route vraagt meer handelingen dan Home Assistant Green of een Raspberry Pi. Gebruik bij twijfel de actuele officiële installatiehandleiding voor jouw hardware.
Voor deze route heb je doorgaans nodig:
- een geschikte 64-bits Intel- of AMD-computer;
- een interne SSD of harde schijf;
- ondersteuning voor UEFI;
- toegang tot de BIOS- of UEFI-instellingen;
- een netwerkkabel;
- een USB-stick;
- een toetsenbord en beeldscherm tijdens de installatie;
- een andere computer om installatiemedia voor te bereiden;
- een actuele back-up van eventueel aanwezige gegevens.
Stap 1 — Controleer of de computer volledig voor Home Assistant wordt gebruikt
Home Assistant OS neemt de computer over.
Na de installatie is dit niet langer een gewone Windows- of Linux-computer. Het apparaat wordt een Home Assistant-server.
Controleer daarom nogmaals:
- of alle belangrijke bestanden zijn gekopieerd;
- of de bestaande installatie mag verdwijnen;
- of de licentie- of herstelgegevens zijn bewaard als je die later nodig hebt;
- of je de juiste fysieke computer voor je hebt.
Gebruik liever geen laptop die je nog voor andere werkzaamheden nodig hebt.
Stap 2 — Open de BIOS- of UEFI-instellingen
Start de mini-pc opnieuw op en druk tijdens het opstarten op de toets waarmee de instellingen worden geopend.
Dat kan bijvoorbeeld zijn:
- F2;
- Delete;
- F1;
- F10;
- Escape.
De juiste toets verschilt per fabrikant.
Zoek in de instellingen naar de opstartconfiguratie.
Home Assistant OS heeft op generieke x86-64-hardware doorgaans nodig:
- UEFI-opstartmodus;
- Secure Boot uitgeschakeld;
- de juiste schijf als opstartapparaat.
Verander alleen instellingen die je begrijpt en noteer de oorspronkelijke waarden.
Sla de wijzigingen op en sluit de instellingen.
Stap 3 — Kies een installatiemethode
Home Assistant OS heeft voor generieke x86-64-hardware geen gewone installatiewizard zoals Windows.
Het image moet rechtstreeks naar de interne schijf worden geschreven.
Een gebruikelijke methode is:
- een tijdelijke Ubuntu-omgeving vanaf een USB-stick starten;
- vanuit die tijdelijke omgeving het Home Assistant OS-image downloaden;
- het image met het schijfhulpprogramma naar de interne schijf schrijven.
Het voordeel van deze methode is dat de interne schijf in de mini-pc kan blijven zitten.
Je kunt het image ook schrijven terwijl de SSD via een adapter aan een andere computer is gekoppeld. Dat is alleen praktisch wanneer de SSD gemakkelijk kan worden verwijderd en je de juiste adapter hebt.
In deze gids gebruiken we de tijdelijke Ubuntu-route op hoofdlijnen. Volg bij de uitvoering altijd de actuele officiële stappen, omdat downloadlinks en programma’s kunnen veranderen.
Stap 4 — Maak een opstartbare Ubuntu-USB-stick
Download op een andere computer de actuele Ubuntu Desktop-installatie.
Schrijf dit image met geschikte software naar een lege USB-stick.
Ook hierbij wordt de inhoud van de USB-stick verwijderd.
Controleer dus goed dat je de juiste USB-stick hebt geselecteerd.
We installeren Ubuntu niet op de mini-pc. We gebruiken de USB-stick alleen om tijdelijk een werkende omgeving te starten.
Stap 5 — Start de mini-pc vanaf de USB-stick
Plaats de Ubuntu-USB-stick in de mini-pc.
Open tijdens het opstarten het opstartmenu en kies de USB-stick.
Selecteer daarna de mogelijkheid om Ubuntu uit te proberen zonder het te installeren. Deze optie wordt meestal aangeduid met een tekst als:
Try Ubuntu
Controleer dat Ubuntu werkelijk vanaf de USB-stick draait.
Wanneer je per ongeluk Ubuntu op de interne schijf installeert, voeg je een onnodige stap toe en kun je gegevens overschrijven voordat je Home Assistant OS schrijft.
Stap 6 — Download het juiste Home Assistant OS-image
Open in de tijdelijke Ubuntu-omgeving de actuele officiële installatiepagina voor generieke x86-64-hardware.
Download het Home Assistant OS-image voor Generic x86-64.
Gebruik geen image voor:
- Raspberry Pi;
- Home Assistant Green;
- een virtuele machine;
- een andere processorarchitectuur.
De bestandsnaam bevat meestal een verwijzing naar generic-x86-64.
Controleer dit voordat je doorgaat.
Stap 7 — Selecteer de interne schijf
Open in Ubuntu het schijfhulpprogramma.
Selecteer de interne SSD of harde schijf waarop Home Assistant OS moet komen.
Controleer bijzonder zorgvuldig:
- de fabrikant;
- de capaciteit;
- het apparaattype;
- of je niet de Ubuntu-USB-stick hebt geselecteerd;
- of er geen andere schijf met belangrijke gegevens is aangesloten.
Het herstellen van het image naar de verkeerde schijf verwijdert de gegevens op die schijf.
Stap 8 — Schrijf het image
Gebruik de functie waarmee een schijfimage kan worden teruggezet of hersteld.
Selecteer het gedownloade Home Assistant OS-image en kies de interne SSD of harde schijf als bestemming.
Bevestig het schrijven.
Wacht tot het volledige proces is afgerond.
Sluit de computer niet af en verwijder de USB-stick niet tijdens het schrijven.
Stap 9 — Sluit Ubuntu af
Wanneer het image volledig is geschreven, sluit je de mini-pc via Ubuntu af.
Verwijder daarna de Ubuntu-USB-stick.
Sluit een netwerkkabel aan die toegang heeft tot je lokale netwerk en internet.
Start vervolgens de mini-pc.
Home Assistant OS hoort nu vanaf de interne schijf te starten.
Wanneer de computer opnieuw Ubuntu opent, is de USB-stick waarschijnlijk nog aangesloten of staat de verkeerde opstartvolgorde ingesteld.
Wanneer helemaal niets start, controleer dan:
- of UEFI is ingeschakeld;
- of Secure Boot is uitgeschakeld;
- of de interne schijf wordt herkend;
- of het juiste image is geschreven;
- of de interne schijf als opstartapparaat is ingesteld.
Home Assistant voor het eerst openen
Vanaf dit punt zijn de stappen voor Home Assistant Green, Raspberry Pi en mini-pc vrijwel hetzelfde.
Laat het apparaat eerst enkele minuten opstarten.
Tijdens de eerste start worden onderdelen voorbereid en mogelijk via internet gedownload. De benodigde tijd hangt af van de hardware, opslag en internetverbinding.
Open daarna op een computer die met hetzelfde netwerk is verbonden een browser.
Ga naar:
http://homeassistant.local:8123
Soms werkt ook:
http://homeassistant.local
Wanneer Home Assistant nog bezig is met voorbereiden, verschijnt een pagina die dit aangeeft.
Wacht rustig tot de voorbereiding is voltooid.
Vernieuw de pagina niet iedere paar seconden en onderbreek de voeding niet.
Wanneer homeassistant.local niet werkt
Wanneer de pagina niet opent, betekent dit niet direct dat de installatie is mislukt.
De naam homeassistant.local gebruikt een methode waarmee apparaten elkaar op het lokale netwerk kunnen vinden. Niet ieder netwerk of besturingssysteem verwerkt die naam op dezelfde manier.
Probeer eerst:
http://homeassistant:8123
Werkt dat niet, zoek dan het IP-adres van Home Assistant op in je router.
Open in de router het overzicht met verbonden apparaten. Zoek naar een naam zoals:
- homeassistant;
- Home Assistant;
- de naam van de mini-pc;
- een nieuw apparaat dat verscheen nadat je Home Assistant inschakelde.
Het IP-adres ziet er bijvoorbeeld zo uit:
192.168.1.50Open vervolgens:
http://192.168.1.50:8123
Gebruik het werkelijke adres dat jouw router toont.
Verschijnt Home Assistant via het IP-adres wel, dan werkt de installatie waarschijnlijk goed. Alleen de lokale naam wordt niet gevonden.
Noteer het IP-adres. We kunnen later in de router een DHCP-reservering maken zodat Home Assistant hetzelfde adres blijft ontvangen.
Wanneer er geen IP-adres verschijnt
Wanneer Home Assistant niet in de router verschijnt, controleer dan eerst de basis:
- Zit de netwerkkabel volledig in beide aansluitingen?
- Brandt of knippert er een netwerklampje?
- Werkt dezelfde kabel met een ander apparaat?
- Werkt de gebruikte aansluiting op de router of switch?
- Is het apparaat daadwerkelijk ingeschakeld?
- Heeft de router automatisch uitgedeelde IP-adressen beschikbaar?
- Is Home Assistant lang genoeg bezig geweest met de eerste start?
Verander niet direct allerlei netwerkinstellingen.
Test eerst één kabel, één routeraansluiting en één apparaat.
Bij een Raspberry Pi kan een verkeerd of beschadigd image voorkomen dat het systeem start. Schrijf de kaart in dat geval opnieuw en probeer zo nodig een andere geheugenkaart.
Bij een mini-pc kun je tijdelijk een beeldscherm aansluiten om te controleren of Home Assistant OS werkelijk wordt gestart.
De welkomstpagina
Wanneer de voorbereiding is voltooid, verschijnt de welkomstpagina van Home Assistant.
Je kunt hier kiezen tussen:
- een nieuwe Home Assistant-omgeving maken;
- een bestaande installatie herstellen vanuit een back-up.
Omdat dit onze eerste installatie is, maken we een nieuwe omgeving.
Kies de optie om een nieuw slim huis aan te maken.
Wanneer je al een bestaande Home Assistant-back-up hebt en bewust migreert, volg dan de herstelroute. Meng de stappen voor een nieuwe installatie en herstel niet door elkaar.
De eerste gebruiker aanmaken
De eerste gebruiker wordt de eigenaar van de Home Assistant-installatie.
Dit account heeft beheerdersrechten en kan alle instellingen wijzigen.
Vul in:
- je zichtbare naam;
- een gebruikersnaam;
- een sterk wachtwoord.
De zichtbare naam is de naam die Home Assistant in de interface gebruikt.
De gebruikersnaam gebruik je om aan te melden. Kies een eenvoudige gebruikersnaam zonder spaties en bewaar deze samen met het wachtwoord in een wachtwoordmanager.
Gebruik een uniek wachtwoord dat je nergens anders gebruikt.
De eigenaarstoegang kan niet op dezelfde manier worden hersteld als bij een gewone online dienst die simpelweg een nieuw wachtwoord per e-mail verstuurt. Bewaar de gegevens daarom zorgvuldig.
Maak geen algemeen account met een eenvoudige naam en deel het niet met alle huisgenoten.
Andere gebruikers kunnen later hun eigen account krijgen.
Je thuislocatie instellen
Home Assistant vraagt waar je huis zich bevindt.
Deze locatie wordt onder andere gebruikt voor:
- zonsopkomst en zonsondergang;
- tijdzone;
- weersinformatie;
- aanwezigheid en zones;
- locatieafhankelijke automatiseringen.
Controleer:
- het land;
- de tijdzone;
- de locatie op de kaart;
- de hoogte indien die wordt gevraagd;
- het gebruikte eenhedenstelsel;
- de valuta.
De locatie hoeft niet onnodig preciezer te zijn dan voor jouw toepassingen nodig is. Bedenk wel dat een sterk afwijkende locatie gevolgen heeft voor zonsopkomst, zonsondergang en locatiegebaseerde functies.
Voor Nederland gebruiken we doorgaans:
- tijdzone Europe/Amsterdam;
- metrische eenheden;
- temperatuur in graden Celsius;
- valuta euro.
Controleer deze keuzes in plaats van ze alleen over te nemen.
Gegevens delen
Tijdens de onboarding kan Home Assistant vragen of je anonieme informatie wilt delen.
Lees welke categorieën beschikbaar zijn en maak een bewuste keuze.
Het delen van statistieken kan ontwikkelaars helpen inzicht te krijgen in gebruikte installaties en integraties. Het is echter niet verplicht om Home Assistant te gebruiken.
Je kunt deze instelling later aanpassen.
Kies niet automatisch alles aan of uit omdat een handleiding dat zegt. Bepaal welke gegevens jij wilt delen.
Automatisch ontdekte apparaten
Home Assistant onderzoekt het lokale netwerk en kan al tijdens de eerste configuratie apparaten en diensten vinden.
Je ziet mogelijk voorstellen voor:
- mediaspelers;
- televisies;
- printers;
- netwerkapparatuur;
- slimme lampen;
- bridges;
- weer- en locatiegegevens;
- andere Home Assistant-installaties.
Voeg nog niet alles toe.
Automatisch gevonden betekent alleen dat Home Assistant iets herkent. Het betekent niet dat je het direct nodig hebt of begrijpt.
Bekijk per ontdekking:
- welk apparaat het is;
- welke integratie wordt voorgesteld;
- of je het apparaat zelf herkent;
- of aanmelding of toestemming nodig is;
- of de verbinding lokaal of via de cloud werkt.
Voorlopig kun je ontdekkingen overslaan. Ze blijven meestal later beschikbaar via Instellingen → Apparaten en diensten.
We voegen ons eerste apparaat in een afzonderlijk hoofdstuk bewust en stap voor stap toe.
De eerste keer aanmelden
Na het afronden van de onboarding opent Home Assistant het standaarddashboard.
Je bent nu aangemeld met het eigenaarsaccount.
Het dashboard kan al kaarten en gevonden informatie bevatten. Welke onderdelen zichtbaar zijn, hangt af van je netwerk en de automatisch geactiveerde basisintegraties.
Klik nog niet overal op.
Neem eerst waar:
- opent de interface zonder foutmelding?
- wordt de juiste tijd weergegeven?
- klopt de locatie?
- verschijnt je gebruikersnaam?
- zijn er waarschuwingen of reparatiemeldingen?
- blijft de interface bereikbaar wanneer je de pagina vernieuwt?
Noteer wat je ziet voordat je instellingen verandert.
Controleren of Home Assistant volledig werkt
Een zichtbare webpagina is een belangrijke stap, maar we willen meer controleren.
Ga naar de systeeminformatie en bekijk:
- de versie van Home Assistant Core;
- de versie van Home Assistant OS;
- de netwerkverbinding;
- de beschikbare opslagruimte;
- het gebruikte geheugen;
- de systeemtijd;
- eventuele waarschuwingen.
De exacte plaats van deze gegevens kan per versie veranderen. Zoek binnen Instellingen → Systeem naar informatie over hardware, netwerk, opslag en reparaties.
Let vooral op meldingen die aangeven dat:
- de opslag bijna vol is;
- de voeding onvoldoende is;
- een onderdeel nog wordt bijgewerkt;
- de tijd niet klopt;
- er reparaties nodig zijn;
- de verbinding met internet ontbreekt.
Los niet direct iedere informatieve melding op. Lees eerst wat er werkelijk staat.
Eerst bijwerken of eerst rondkijken?
Een nieuwe installatie kan direct updates aanbieden.
Voordat je allerlei apparaten toevoegt, is het verstandig de basisinstallatie naar een actuele stabiele versie bij te werken.
Controleer eerst:
- of de installatie betrouwbaar opent;
- of je aanmeldgegevens zijn opgeslagen;
- of er geen ernstige systeemmelding aanwezig is;
- of je tijd hebt om na de update opnieuw te controleren.
Lees daarna de update-informatie en voer de beschikbare updates één voor één of in een overzichtelijke volgorde uit.
Onderbreek de voeding niet tijdens een update.
Home Assistant kan tijdens het bijwerken tijdelijk onbereikbaar zijn. Dat is niet automatisch een fout.
Wacht enkele minuten voordat je ingrijpt.
Een eerste back-up maken
Zodra de installatie en onboarding correct zijn afgerond, maken we een eerste back-up.
Deze back-up bevat nog weinig persoonlijke configuratie, maar vormt wel een schoon herstelpunt.
Geef de back-up een duidelijke naam, bijvoorbeeld:
Eerste installatie na onboarding
Vermeld eventueel de datum.
Bewaar later ook een kopie buiten het Home Assistant-apparaat. Een back-up die uitsluitend op dezelfde defecte opslag staat, helpt niet wanneer die opslag niet meer leesbaar is.
In het hoofdstuk over back-ups, updates en herstel bouwen we hiervoor een complete werkwijze.
Home Assistant opnieuw starten
Een systeem is pas betrouwbaar wanneer het niet alleen één keer start, maar ook na een herstart terugkomt.
Gebruik voor deze test de herstartfunctie binnen Home Assistant.
Trek niet zomaar de voeding los.
Een gecontroleerde herstart geeft Home Assistant de gelegenheid om gegevens correct weg te schrijven en onderdelen netjes af te sluiten.
Start Home Assistant opnieuw en noteer vooraf:
- hoe laat je de herstart uitvoert;
- welk adres je gebruikt;
- wat je verwacht te zien.
Tijdens de herstart verdwijnt de webinterface tijdelijk.
Probeer na enkele minuten opnieuw:
http://homeassistant.local:8123
of het eerder gevonden IP-adres.
Controleer na de herstart:
- kun je de aanmeldpagina openen?
- kun je met hetzelfde account aanmelden?
- klopt de tijd?
- zijn de instellingen bewaard?
- zijn er nieuwe waarschuwingen?
- verschijnt het dashboard weer?
Wanneer dit lukt, weten we dat Home Assistant niet alleen geïnstalleerd is, maar ook zelfstandig opnieuw kan opstarten.
Het IP-adres vastleggen
Je router deelt waarschijnlijk automatisch een IP-adres uit.
Dat adres kan later veranderen. Voor een centrale server is een voorspelbaar adres handig.
De veiligste aanpak is meestal een DHCP-reservering in de router. Daarmee blijft de router verantwoordelijk voor de adresverdeling, maar reserveert hij hetzelfde adres voor Home Assistant.
Zoek in je router naar een instelling als:
- DHCP-reservering;
- vast leaseadres;
- static lease;
- reserved address;
- always use this IP address.
Controleer voordat je de reservering opslaat:
- het MAC-adres van Home Assistant;
- het huidige IP-adres;
- of het adres binnen het bereik van je netwerk past;
- of het adres niet voor een ander apparaat is gereserveerd.
Deze stap is handig, maar niet verplicht om verder te gaan.
Wanneer je niet zeker weet hoe jouw router werkt, noteer dan voorlopig alleen het huidige IP-adres.
Als Home Assistant na een herstart niet terugkomt
Wacht eerst voldoende lang.
Een herstart kan langer duren wanneer:
- een update wordt afgerond;
- de opslag langzaam is;
- apps worden gestart;
- netwerkapparatuur nog verbinding opbouwt;
- de computer een volledige hardwarestart uitvoert.
Controleer daarna één voor één:
- Heeft het apparaat voeding?
- Is de netwerkkabel aangesloten?
- Verschijnt het apparaat in de router?
- Heeft het hetzelfde of een nieuw IP-adres?
- Werkt het IP-adres met poort 8123?
- Geeft een aangesloten beeldscherm informatie?
- Zijn er foutmeldingen of reparatiemeldingen?
Start niet voortdurend opnieuw.
Iedere nieuwe onderbreking kan het lopende opstartproces opnieuw afbreken en maakt het moeilijker om te bepalen wat er werkelijk gebeurt.
Veelvoorkomende installatieproblemen
De voorbereidingspagina blijft lang zichtbaar
Tijdens de eerste start downloadt en configureert Home Assistant verschillende onderdelen.
Controleer:
- of de internetverbinding werkt;
- of de netwerkkabel goed vastzit;
- of de router het apparaat een IP-adres heeft gegeven;
- of de datum en tijd op het netwerk correct beschikbaar zijn;
- of je voldoende lang hebt gewacht.
Vernieuw de pagina één keer na enige tijd. Verbreek niet direct de voeding.
De browser toont dat de pagina niet bereikbaar is
Controleer eerst of je het juiste adres gebruikt:
http://homeassistant.local:8123
Let op het gebruik van http tijdens de lokale eerste installatie.
Probeer daarna het IP-adres uit de router:
http://IP-ADRES:8123
Controleer ook of je computer niet op een geïsoleerd gastnetwerk zit.
De Raspberry Pi start niet
Mogelijke oorzaken zijn:
- verkeerd image geselecteerd;
- image niet volledig geschreven;
- beschadigde geheugenkaart;
- ongeschikte voeding;
- kaart verkeerd geplaatst;
- verkeerd Raspberry Pi-model gekozen.
Schrijf het image opnieuw en laat de verificatie volledig afronden. Gebruik bij twijfel een andere betrouwbare geheugenkaart en de juiste voeding.
De mini-pc vindt geen opstartschijf
Controleer:
- of UEFI is ingeschakeld;
- of Secure Boot is uitgeschakeld;
- of het x86-64-image is gebruikt;
- of het image naar de interne schijf is geschreven;
- of de juiste opstartschijf is geselecteerd;
- of de interne schijf door de BIOS wordt herkend.
Verander één instelling tegelijk en noteer het resultaat.
De pagina opent op de ene computer wel en op de andere niet
Wanneer het IP-adres werkt maar homeassistant.local niet, ligt het probleem waarschijnlijk bij de naamherkenning en niet bij Home Assistant zelf.
Wanneer geen enkel lokaal adres werkt op één apparaat, controleer dan:
- of het apparaat op hetzelfde netwerk zit;
- of een VPN actief is;
- of het gastnetwerk apparaten van elkaar scheidt;
- of browser- of firewallsoftware lokale verbindingen blokkeert.
De verkeerde locatie of tijdzone is ingesteld
Corrigeer dit via de algemene Home Assistant-instellingen.
Een verkeerde tijdzone beïnvloedt:
- geschiedenis;
- logboeken;
- automatiseringen op tijd;
- zonsopkomst en zonsondergang;
- meldingen.
Controleer daarom de weergegeven tijd voordat je verdergaat.
Een voorspelling doen
Voordat we het hoofdstuk afsluiten, doen we een eenvoudige test.
Voorspel eerst wat er gebeurt wanneer je Home Assistant opnieuw start.
Schrijf bijvoorbeeld op:
De webinterface verdwijnt tijdelijk. Het apparaat blijft in de router zichtbaar of verschijnt na korte tijd opnieuw. Daarna kan ik via hetzelfde adres aanmelden en zijn mijn instellingen bewaard.
Voer vervolgens een gecontroleerde herstart uit.
Noteer:
- hoe lang Home Assistant niet bereikbaar was;
- of het IP-adres gelijk bleef;
- welke pagina als eerste verscheen;
- of je opnieuw moest aanmelden;
- of er meldingen zichtbaar waren;
- of de instellingen bewaard zijn gebleven.
Door eerst een verwachting uit te spreken, verandert wachten in een test.
Wat hebben we aangetoond?
Wanneer alle controles zijn geslaagd, hebben we meer gedaan dan Home Assistant alleen installeren.
We hebben aangetoond dat:
- Home Assistant OS vanaf de gekozen opslag start;
- het apparaat verbinding heeft met het lokale netwerk;
- de webinterface bereikbaar is;
- het eigenaarsaccount werkt;
- locatie en tijdzone correct zijn ingesteld;
- instellingen na een herstart bewaard blijven;
- Home Assistant zelfstandig opnieuw beschikbaar komt;
- we weten waar het IP-adres kan worden gevonden;
- er een eerste herstelpunt kan worden gemaakt.
Dat vormt een betrouwbare basis voor de volgende stappen.
Wat je uit dit hoofdstuk kunt meenemen
Home Assistant Green wordt kant-en-klaar geleverd en hoeft alleen met netwerk en voeding te worden verbonden.
Bij een Raspberry Pi schrijven we Home Assistant OS met Raspberry Pi Imager naar de juiste opslag. Bij een mini-pc schrijven we het x86-64-image naar de interne schijf en zorgen we dat de computer in UEFI-modus daarvan kan opstarten.
Het schrijven van een image verwijdert de bestaande gegevens op de gekozen opslag. Controleer daarom altijd de naam en capaciteit van de doelschijf.
Na de eerste start openen we Home Assistant via:
http://homeassistant.local:8123
Wanneer die naam niet werkt, zoeken we het IP-adres in de router en gebruiken we:
http://IP-ADRES:8123
Tijdens de onboarding maken we het eigenaarsaccount aan en stellen we locatie, tijdzone en eenheden in. Automatisch ontdekte apparaten hoeven we nog niet direct toe te voegen.
Tot slot controleren we of Home Assistant na een gecontroleerde herstart zelfstandig terugkomt.
In het volgende hoofdstuk gaan we de interface leren kennen. We bekijken waar de belangrijkste instellingen, apparaten, automatiseringen, logboeken en systeeminformatie te vinden zijn.
Actuele installatiehulp
Home Assistant en de gebruikte installatieprogramma’s worden regelmatig bijgewerkt. Daardoor kunnen schermafbeeldingen, menunamen en downloadlinks veranderen.
Controleer voor de daadwerkelijke installatie altijd de actuele officiële documentatie voor jouw hardware.
Vergelijk daarbij drie dingen:
- komt het gekozen apparaat overeen met jouw hardware?
- gebruik je het juiste Home Assistant OS-image?
- komt de waarschuwing over het wissen van de geselecteerde opslag overeen met wat je van plan bent?
Volg geen verouderde downloadlink uit een oude video wanneer de officiële installatiepagina een nieuwere route toont.
De stappen kunnen veranderen. De controle blijft hetzelfde: