Så förhindrar du att Home Assistant-konfigurationen går förlorad vid uppgraderingar

Eva Wong

IceWhale author

Eva Wong är Teknisk skribent och den boende fixaren på ZimaSpace. En livslång nörd med en passion för hemma-labb och öppen källkod, hon specialiserar sig på att översätta komplexa tekniska koncept till tillgängliga, praktiska guider. Eva tror att självhosting ska vara roligt, inte skrämmande. Genom sina handledningar ger hon gemenskapen verktyg att avmystifiera hårdvaruinstallationer, från att bygga sin första NAS till att bemästra Docker-containrar.

How to Prevent Home Assistant Configuration Loss During Upgrades - Zima Store Online

Förhindra att Home Assistant-konfigurationen går förlorad genom att göra det inbyggda säkerhetskopieringssystemet till den primära återställningsvägen och behandla körmiljön som utbytbar. Home Assistant-versionen, containeravbildningen eller värden kan ändras, men säkerhetskopian, krypteringsnyckeln, körmiljödefinitionen och alla externa beroenden måste fortfarande finnas tillgängliga när den ursprungliga maskinen är borta.

Moderna säkerhetskopior av Home Assistant fungerar med alla installationstyper, inklusive Container. Behåll en separat manuell kopia av konfigurationsträdet om det tillför värde, men bygg inte hela uppgraderingsplanen på att kopiera filer för hand samtidigt som du ignorerar det stödda arbetsflödet för säkerhetskopiering och återställning.

Börja med en inbyggd säkerhetskopia, inte en manuellt kopierad YAML-mapp

Reducera inte ”konfiguration” till configuration.yaml. Home Assistants stödda säkerhetskopieringssystem fångar det applikationstillstånd som krävs för återställning, inklusive konfigurations- och databasinnehåll, medan nyare arbetsflöden för säkerhetskopiering även stöder automatisering, lagring och platser utanför värden.

Den omfattande uppdateringen av säkerhetskopieringen som lanserades 2025 införde automatiska krypterade säkerhetskopior, lagringskontroller och säkerhetskopieringsplatser utanför den lokala miljön. Därför bör den inbyggda säkerhetskopian vara den första återställningstillgången du verifierar före en uppgradering, i stället för att förlita dig på en ofullständig manuell kopia.

Dokumentera ändå konfigurationsroten, databasalternativet, referenser till hemligheter, anpassade komponenter, SSL-material och alla externa filer eller tjänster som en integration kräver. En säkerhetskopia kan återställa Home Assistant-tillståndet utan att automatiskt dokumentera varje USB-enhet, nätverkssökväg, databasserver eller containerparameter runt omkring.

Gör beständig lagring och körinställningar för containern tydliga

För Docker ska du bekräfta bind-monteringen eller volymen som äger /config och bevara Compose- eller kördefinitionen som återskapar nätverksläge, enhetsmappningar, tidszon, behörigheter och externa tjänster. Själva containerfilsystemet bör förbli förbrukningsbart.

En diskussion om säkerhetskopiering av Home Assistant i Docker visar tydligt vad som kan gå fel: när användare mappar endast en fil i stället för hela konfigurationskatalogen kan viktigt tillstånd bli kvar inuti containern och försvinna när körmiljön ersätts.

Verifiera värdens montering före uppgraderingen och förvara körmiljödefinitionen tillsammans med säkerhetskopian. Återställningen går mycket snabbare när både applikationstillståndet och instruktionerna som krävs för att exponera radioenheter, portar, nätverk och lagring redan är kända.

Flytta minst en krypterad säkerhetskopia utanför värden

En säkerhetskopia på samma SSD skyddar mot vissa konfigurationsfel, men inte mot förlust av värden, korruption i filsystemet, stöld eller ett trasigt lagringsmedium. Förvara minst en återställningskopia på en NAS, en annan dator eller en fjärransluten säkerhetskopieringsplats vars åtkomst inte är beroende av den felaktiga Home Assistant-värden.

Förvara även säkerhetskopians krypteringsnyckel eller nödpaket utanför Home Assistant. Home Assistant 2026.4 flyttade nya krypterade säkerhetskopior till det granskade SecureTar v3-formatet med starkare modern kryptering, vilket förbättrar säkerheten men gör hanteringen av nyckeln till en uttrycklig del av återställningsmöjligheten.

Versionshantera säkerhetskopian i stället för att skriva över samma fil. En uppgradering kan avslöja ett problem flera dagar senare, och den senaste återställningspunkten kan redan innehålla det migrerade eller skadade tillstånd som du försöker undvika.

Featured

ZimaCube 2 personlig molnhem NAS

ZimaCube2

Säkerhetskopian ersätter fortfarande inte din körmiljödefinition

Konfigurationen ensam kanske inte återställer USB-radioenheter, nätverk på värden, tidszon, enhetsvidarebefordran, databastjänster, MQTT eller relationer till omvänd proxy. Bevara Compose-filen, policyn för avbildningsversioner, miljövariabler, sökvägar på värden, enhetsmappningar och de tjänsteberoenden som krävs för att återskapa körmiljön.

Lägg inte klartexthemligheter i ett offentligt arkiv enbart för att versionshantera Compose-filen. Förvara hemliga värden på en skyddad plats och dokumentera endast varifrån återställningsprocessen hämtar dem.

ZimaSpaces distributionsguide för Home Assistant på ZimaBoard är ett användbart sammanhang för att skilja hemserverplattformen från det applikationstillstånd som måste överleva framtida förändringar av distributionen.

Genomför ett återställningstest innan uppgraderingen blir akut

En säkerhetskopia är inte bevisad bara för att arkivet finns. Återställ den till ett isolerat mål eller en tillfällig container, återanslut representativa enheter och sökvägar där det är praktiskt möjligt och bekräfta att systemet återkommer med användare, instrumentpaneler, integrationer, automatiseringar, hjälpare och förväntat tillstånd.

Använd testet för att upptäcka saknade lösenord, inaktuella sökvägar på värden, odokumenterade enhetsmappningar och överdimensionerade databaser medan produktionssystemet fortfarande fungerar. Dokumentera återställningsstegen efter ett lyckat test; minnet är ingen återställningsplan.

Ta omedelbart före uppgraderingen en ny återställningspunkt, dokumentera den aktuella Home Assistant-versionen och containeravbildningen och kontrollera versionsändringar som påverkar dina integrationer. Behåll den tidigare körmiljön tillgänglig tills den uppgraderade instansen har klarat både en normal användningsperiod och en omstart.

Använd en säkerhetskontroll i fyra delar inför uppgraderingen

Återställningstillgång	Vad den skyddar	Fel om den saknas
Inbyggd säkerhetskopia	Home Assistant-konfiguration och återställningsbart applikationstillstånd	Ingen stödd återställningspunkt
Krypteringsnyckel / nödpaket	Åtkomst till skyddade säkerhetskopior	Säkerhetskopian finns, men kan inte öppnas
Körmiljödefinition	Monteringar, enheter, nätverk och miljö	Korrekt tillstånd men bruten tjänsteåtkomst
Kopia utanför värden + återställningstest	Fel på värden och procedurens giltighet	Återställningen försvinner med produktionen eller misslyckas när den behövs

Uppgradera endast när alla fyra finns på plats. En manuell kopia av konfigurationsträdet kan finnas kvar som ett extra lager, men den primära återställningsplanen bör vara en stödd säkerhetskopia som du kan dekryptera och återställa tillsammans med en dokumenterad körmiljö.