Home Assistant virker ikke efter en opdatering: hvad skal du kontrollere, og hvordan gendanner du systemet?

Opdateringer af Home Assistant gennemføres normalt uden problemer. En gang imellem åbner brugerfladen dog ikke efter genstart, integrationer bliver utilgængelige, automatiseringer reagerer ikke, eller systemet genstarter igen og igen.

En fejl, der opdages efter en opdatering, betyder ikke nødvendigvis, at hele installationen er beskadiget. Den sikreste fremgangsmåde er først at afgrænse problemet, gemme relevante oplysninger og derefter vælge næste skridt.

• Brugerfladen åbner slet ikke: årsagen kan være Home Assistant, værten, en virtuel maskine, en container, netværket eller blot den adresse, du bruger.
• Brugerfladen åbner, men integrationer eller entiteter er utilgængelige: det er normalt ikke et totalt nedbrud. Begynd med den berørte integration og dens meddelelser.
• Automatiseringer kører ikke: kontrollér, at de er aktiveret, at udløsere og betingelser modtager data, og hvad sporingen viser.
• Der kommer fejl eller genstarter: notér tidspunkt og hyppighed. Et gentaget mønster kan skelne mellem et Core-problem og fejl på vært eller lager.
• Kun én app eller brugerdefineret komponent svigter: undersøg den separat, før du gendanner hele systemet.

Hvis symptomet er én tilstand med unavailable, finder du en mere målrettet kontrol i vejledningen om en utilgængelig Home Assistant-entitet.

At to ting sker samtidig, beviser ikke, at den ene forårsagede den anden. En enhed kan have fået en ny IP-adresse, et cloud-token kan være udløbet, lageret kan være svigtet, eller routeren kan have fået et problem på samme tidspunkt.

Fastslå, om opdateringen gjaldt Home Assistant Core, Home Assistant OS, Supervisor, en app, en producentintegration eller en HACS-komponent. Notér versionen før og efter, det omtrentlige tidspunkt og det første synlige symptom. Læs udgivelsesnoterne og afsnittet om bagudinkompatible ændringer for den del, der blev opdateret.

Hvis flere dele blev opdateret samtidig, bør du ikke gætte på årsagen. Sammenhold tidspunkterne med logfilerne og den tidligste fejl.

• Bekræft, at værten er tændt og synlig i routeren eller konsollen til den virtuelle maskine.
• Prøv den lokale IP-adresse eller det korrekte værtsnavn. Manglende fjernadgang beviser ikke, at Home Assistant er stoppet lokalt.
• Hvis brugerfladen virker, så gennemgå Indstillinger → System → Logfiler og Reparationer. Den første opstartsfejl er ofte mere værdifuld end mange efterfølgende følgefejl.
• Kontrollér systemoplysninger og ledig plads. Et fuldt lager kan blokere database-skrivning, opdateringer og normal opstart.
• I Home Assistant OS kan konsol og CLI vise status og logfiler for Core, Supervisor og værten. I Docker eller en virtuel maskine skal de tilsvarende lag kontrolleres med platformens egne værktøjer.

Undgå gentagne genstarter, før du har gemt meddelelserne. En genstart kan fjerne det tydeligste spor af, hvornår fejlen begyndte.

Recovery mode vises, når Home Assistant finder et konfigurationsproblem og indlæser et minimalt sæt integrationer, så konfigurationen kan repareres. Tilstanden peger derfor mod konfiguration eller indlæsningsfejl.

Safe mode starter Home Assistant Core uden brugerdefinerede integrationer, kort eller temaer. Hvis fejlen forsvinder i Safe mode, ligger årsagen uden for selve Core og ofte i HACS eller et andet brugerdefineret element.

Safe mode er et diagnoseværktøj, ikke en løsning i sig selv. Gem logfilerne, og find den ansvarlige komponent, før du deaktiverer eller sletter noget.

• Integrationer: kontrollér konfigurationsstatus, krav om ny godkendelse, Reparationer og integrationens egne logmeddelelser.
• Entiteter: sammenlign, om én entitet, hele enheden eller alle enheder i integrationen er utilgængelige.
• Automatiseringer: gennemgå spor, udløsere, betingelser og afhængige entiteter. En opdatering kan afsløre en ældre fejl eller en ændret handling.
• Apps: adskil appens tilstand fra Home Assistant Core, og læs dens egen log.
• HACS og brugerdefinerede komponenter: kontrollér kompatibilitet og kendte problemer hos udvikleren. Opdatér ikke flere komponenter på én gang under fejlfinding.

En enkelt defekt integration kræver sjældent gendannelse af hele installationen. Vejledningerne om Home Assistant-integrationer og automatiseringer giver mere baggrund.

Hvis brugerfladen ikke svarer, Core ikke starter, eller værten genstarter hele tiden, skal installationslaget undersøges. I Home Assistant OS omfatter det system og lager; i Docker også container, volumes og motorens logfiler; i en virtuel maskine ressourcer, virtuel disk og hypervisorens konsol.

Hvis mange integrationer pludselig forsvinder, kan årsagen være netværk, DNS, USB eller lager. På en PC eller mini-PC er det vigtigt at kende installationsmetoden og placeringen af data; vejledningen om Home Assistant på PC, mini-PC og bærbar forklarer grundlaget.

Hvis du ser input/output-fejl, et beskadiget filsystem eller ustabil hardware, kan flere genstarter og opdateringer gøre gendannelsen vanskeligere. Sikr først de data, der stadig er tilgængelige.

En nyere backup kan gendanne konfiguration og udvalgte data, men en gendannelse overskriver de valgte dele af det nuværende system. Derfor kan automatiseringer, enheder, historik og andre ændringer efter backupdatoen blive rullet tilbage.

Kontrollér dato, indhold, lagerplacering og adgang til krypteringsnøglen før gendannelse. Hvis systemet stadig virker delvist, så gem de aktuelle logfiler og konfigurationen. Vurdér derefter, om en fuld gendannelse, en delvis gendannelse eller en målrettet reparation er sikrest.

Vejledningen om backup og gendannelse i Home Assistant forklarer forberedelsen mere detaljeret.

• Slet ikke tilfældige konfigurationsfiler, databaser eller komponentmapper.
• Fjern og tilføj ikke flere integrationer igen på én gang.
• Installér ikke flere opdateringer blot for at se, om problemet forsvinder.
• Gendan ikke en gammel backup uden at kontrollere, hvad den overskriver.
• Nulstil ikke hele installationen, før du ved, om fejlen ligger i Core, værten, netværket eller én app.
• Del ikke komplette logfiler offentligt, før du har kontrolleret dem for adresser, tokens og andre private oplysninger.

God fejlfinding ændrer én ting ad gangen og kontrollerer resultatet efter hvert trin. Så ved du, hvad der faktisk hjalp.

• Home Assistant starter ikke eller sidder fast i en genstartsløkke.
• Logfilerne viser fejl i migrering, database, filsystem eller input/output.
• Systemet starter kun i Recovery mode eller Safe mode, men årsagen er stadig uklar.
• Flere uafhængige integrationer svigter samtidig.
• Problemet kan involvere Docker, en virtuel maskine, Home Assistant OS, lager eller hardware.
• Du er usikker på, om backupen er komplet, og hvilke data en gendannelse vil rulle tilbage.

På dette tidspunkt kan tilfældige forsøg gøre konfigurationen sværere at redde. Stop ændringerne, gem logfilerne, og notér versioner og allerede udførte trin.

Jeg kan hjælpe med fjernsupport til at finde årsagen og vælge den sikreste måde at få systemet i drift igen.

• Home Assistant: Recovery mode og Safe mode
• Home Assistant: Reparationer
• Home Assistant: backup og gendannelse
• Home Assistant OS: logfiler, CLI og opdateringer