Zo voorkomt u dat uw Home Assistant-configuratie verloren gaat tijdens upgrades

Voorkom verlies van je Home Assistant-configuratie door het ingebouwde back-upsysteem als primaire herstelmethode te gebruiken en de runtime als vervangbaar te beschouwen. De Home Assistant-versie, containerimage of host kan veranderen; de back-up, encryptiesleutel, runtime-definitie en alle externe afhankelijkheden moeten beschikbaar blijven wanneer de oorspronkelijke machine verdwenen is.

Moderne Home Assistant-back-ups werken met alle installatietypen, waaronder Container. Bewaar indien nuttig een afzonderlijke handmatige kopie van de configuratiestructuur, maar bouw het volledige upgradeplan niet rond het handmatig kopiëren van bestanden terwijl je de ondersteunde back-up- en herstelworkflow negeert.

Begin met een ingebouwde back-up, niet met een handmatig gekopieerde YAML-map

Beperk “configuratie” niet tot configuration.yaml. Het ondersteunde back-upsysteem van Home Assistant legt de applicatiestatus vast die nodig is voor herstel, waaronder configuratie- en database-inhoud. Nieuwere back-upworkflows ondersteunen bovendien automatisering, bewaarbeleid en externe opslaglocaties.

De back-upvernieuwing die in 2025 werd geïntroduceerd, voegde automatische versleutelde back-ups, bewaarbeheer en externe back-uplocaties toe. Daardoor is de ingebouwde back-up het eerste herstelmiddel dat je vóór een upgrade moet controleren, in plaats van te vertrouwen op een onvolledige handmatige kopie.

Leg nog steeds de configuratieroot, databasekeuze, verwijzingen naar secrets, aangepaste componenten, SSL-materiaal en alle externe bestanden of services vast die een integratie nodig heeft. Een back-up kan de Home Assistant-status herstellen zonder automatisch elk USB-apparaat, netwerkpad, databasehost of elke containerparameter eromheen te documenteren.

Leg persistente containeropslag en runtime-instellingen expliciet vast

Controleer bij Docker de bind mount of het volume dat eigenaar is van /config en bewaar de Compose- of run-definitie waarmee je de netwerkmodus, apparaatkoppelingen, tijdzone, rechten en externe services opnieuw kunt aanmaken. Het containerbestandssysteem zelf moet vervangbaar blijven.

Een discussie over Docker-back-ups van Home Assistant laat de foutmodus duidelijk zien: wanneer gebruikers slechts één bestand in plaats van de volledige configuratiemap koppelen, kan belangrijke status in de container achterblijven en verdwijnen wanneer die runtime wordt vervangen.

Controleer vóór de upgrade de hostkoppeling en bewaar de runtime-definitie naast de back-up. Herstel gaat veel sneller wanneer zowel de applicatiestatus als de instructies voor het beschikbaar maken van radio's, poorten, netwerken en opslag al bekend zijn.

Verplaats ten minste één versleutelde back-up buiten de host

Een back-up op dezelfde SSD beschermt tegen sommige configuratiefouten, maar niet tegen verlies van de host, beschadiging van het bestandssysteem, diefstal of een defect opslagapparaat. Bewaar ten minste één herstelkopie op een NAS, een andere computer of een externe back-uplocatie waarvan de toegang niet afhankelijk is van de defecte Home Assistant-host.

Bewaar de encryptiesleutel voor de back-up of noodkit ook buiten Home Assistant. Home Assistant 2026.4 verplaatst nieuwe versleutelde back-ups naar het gecontroleerde SecureTar v3-formaat met sterkere moderne encryptie. Dat verbetert de back-upbeveiliging, maar maakt sleutelbeheer een expliciet onderdeel van herstelbaarheid.

Bewaar versies van de back-up in plaats van steeds hetzelfde bestand te overschrijven. Een upgrade kan pas dagen later een probleem onthullen, en het nieuwste herstelpunt kan de gemigreerde of beschadigde status bevatten waaraan je juist probeert te ontsnappen.

Featured

ZimaCube 2 Persoonlijke Cloud Home NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

De back-up vervangt je runtime-definitie nog steeds niet

Met alleen de configuratie worden USB-radio's, hostnetwerken, tijdzone, apparaattoegang, databaseservices, MQTT of relaties met een reverse proxy mogelijk niet hersteld. Bewaar het Compose-bestand, beleid voor imageversies, omgevingsvariabelen, hostpaden, apparaatkoppelingen en serviceafhankelijkheden die nodig zijn om de runtime opnieuw aan te maken.

Zet geen plaintext-secrets in een openbare repository alleen om het Compose-bestand te kunnen versioneren. Bewaar geheime waarden op een beveiligde locatie en documenteer alleen waar het herstelproces ze vandaan haalt.

De Home Assistant-implementatiegids op ZimaBoard van ZimaSpace biedt nuttige context voor het scheiden van het home-serverplatform en de applicatiestatus die toekomstige implementatiewijzigingen moet overleven.

Voer een hersteltest uit voordat de upgrade een noodgeval wordt

Een back-up is niet bewezen omdat het archief bestaat. Herstel deze op een geïsoleerd doel of in een tijdelijke container, verbind waar praktisch representatieve apparaten en paden opnieuw en controleer of het systeem terugkeert met gebruikers, dashboards, integraties, automatiseringen, helpers en de verwachte status.

Gebruik de test om ontbrekende wachtwoorden, verouderde hostpaden, niet-gedocumenteerde apparaatkoppelingen en te grote databases te ontdekken terwijl het productiesysteem nog werkt. Noteer de herstelstappen na een geslaagde test; geheugen is geen herstelplan.

Maak vlak vóór de upgrade een nieuw herstelpunt, noteer de huidige Home Assistant-versie en het containerimage en controleer de releasewijzigingen die van invloed zijn op je integraties. Houd de vorige runtime beschikbaar totdat de geüpgradede instantie zowel een normale gebruiksperiode als een herstart heeft doorstaan.

Gebruik een vierdelige veiligheidscontrole voor upgrades

Voer de upgrade alleen uit wanneer je alle vier beheert. Een handmatige kopie van de configuratiestructuur kan een extra beveiligingslaag blijven, maar het primaire herstelplan moet bestaan uit een ondersteunde back-up die je kunt ontsleutelen en herstellen, samen met een gedocumenteerde runtime.