Home Assistant veilig terugzetten na een incompatibele release

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Draai Home Assistant terug met een herstelpunt van vóór de update dat overeenkomt met de oudere Core-versie; ga er niet van uit dat het starten van een oude runtime nieuwere migraties van persistente gegevens ongedaan maakt.

De veiligste manier om terug te draaien begint vóór de eerste herstelpoging: bewaar de mislukte toestand van na de update, zoek de laatst bekende goede versie en back-up op en bepaal of de incompatibiliteit in Core, een aangepaste integratie, een add-on of een externe database zit. Terugdraaien is alleen geslaagd wanneer de vorige runtime de herstelde toestand kan lezen en de oorspronkelijke functies in huis weer werken. De versie wijzigen en gegevens terugzetten vormen één herstelbewerking, geen twee losstaande knoppen.

Bewaar de mislukte toestand voordat u probeert te downgraden

Overschrijf niet de enige kopie van de configuratie van na de update terwijl u dingen uitprobeert. Bewaar de huidige configuratie, logboeken, versienummers, databaselocatie en de exacte functie die niet meer werkte. Die kopie kan nieuwe wijzigingen bevatten die na de laatste goede back-up zijn aangebracht, en bewijs leveren dat later nodig is om de incompatibiliteit te begrijpen.

Een regressie bij het terugzetten van back-ups in 2026 liet zien dat zelfs een schijnbaar geslaagde back-upterugzetting de runtime op de verkeerde versie kan laten staan wanneer het omliggende gedrag van Supervisor niet goed werkt. Het verslag over het terugzetten van een back-up en het terugdraaien van de Core-versie is een goede reden om na het terugzetten de daadwerkelijke versie te controleren en niet op de voltooiingsmelding te vertrouwen.

Breng geen configuratiewijzigingen meer aan totdat het herstelpad bekend is. Als de update één optionele aangepaste component heeft ontregeld terwijl de rest van Home Assistant stabiel is, kan het veiliger zijn die component uit te schakelen dan alles terug te draaien. Als Core niet kan starten, de database niet wordt geladen of essentiële automatiseringen onbruikbaar zijn, kies dan voor het gecombineerde herstel van runtime en toestand.

Kies een herstelpunt van vóór de incompatibele release

Zoek de meest recente back-up die is gemaakt toen de oudere versie van Home Assistant nog goed werkte. Vergelijk de tijdstempel met eventuele belangrijke wijzigingen in automatiseringen, gebruikers, dashboards of geschiedenis die u bereid bent te verliezen. Het herstelpunt is een afweging: het herstelt de compatibiliteit door de persistente toestand terug te zetten naar een eerder moment.

De richtlijn van ZimaSpace om een momentopname van appgegevens te maken vóór een update is de preventieve toepassing van dezelfde regel: terugdraaien tijdens runtime verloopt het soepelst wanneer er een kopie van een bekende goede toestand bestaat van vóór de nieuwe software voor het eerst naar productiegegevens schrijft.

Als er geen betrouwbare back-up van vóór de update bestaat, maak er dan niet zelf een door de al gemigreerde database te kopiëren en die aan een oude Core-image te koppelen. Bewaar de huidige status en onderzoek een oplossing vooruit of een gecontroleerde herbouw. Terugzetten zonder een compatibele kopie van de status kan van één incompatibele functie problemen met Recorder, geschiedenis of registers maken.

Herstel de runtime en persistente status als bij elkaar horend paar

Gebruik voor Home Assistant OS of een beheerde installatie het ondersteunde herstelproces om het gekozen herstelpunt terug te zetten en controleer of de bedoelde Core-versie daadwerkelijk start. Voor containerinstallaties is alleen het image terugzetten niet genoeg als de nieuwere release persistente gegevens heeft gewijzigd; herstel ook de bijbehorende configuratiekopie van vóór de update.

Een probleem met Home Assistant Core over het downgraden van 2025.4 naar 2025.3 beschreef dat Recorder, geschiedenis en gerelateerde integraties niet meer werkten wanneer de oudere runtime een nieuwere databasestructuur tegenkwam. In de reactie van de beheerder staat uitdrukkelijk dat terugzetten afhankelijk is van het herstellen van een back-up, en niet van een methode om de database ter plekke te downgraden.

Herstel externe databases en afhankelijke services alleen naar compatibele herstelpunten als de Home Assistant-back-up ze niet omvat. Zet niet zomaar alle containers terug naar een eerdere versie. MQTT, proxies en radioapparatuur kunnen naar behoren werken en ongewijzigd blijven; richt het terugzetten op componenten waarvan de versie of statusafspraken daadwerkelijk zijn gewijzigd.

Controleer de oorspronkelijke storing voordat je automatische updates weer inschakelt

Controleer na het terugzetten de actieve Core-versie, het inloggen, Recorder/geschiedenis, belangrijke integraties, automatiseringen, dashboards en één apparaat van elk kritiek protocol. Herhaal de handeling die op de incompatibele release mislukte en controleer of die nu werkt zonder nieuwe fouten. Start Home Assistant daarna opnieuw op en herstart de host één keer.

Bewaar de kopie van de status met de storing en de update-opmerkingen totdat de volgende release of oplossing is getest. Als een aangepaste integratie de incompatibiliteit heeft veroorzaakt, controleer dan de ondersteunde versies voordat je de volgende Core-update uitvoert. Als het terugzetten mislukt, wissel dan niet herhaaldelijk tussen versies met dezelfde wijzigbare database; ga terug naar het schone herstelpunt of voer een herbouw uit met selectief herstel.

Slaag als de oude versie en de herstelde status stabiel blijven bij normaal gebruik en na een herstart, en de oorspronkelijke storing is verdwenen. Schaal op als de back-up niet kan worden hersteld, de oudere runtime de status nog steeds niet kan lezen of er voor kritieke gegevens geen compatibel herstelpunt is. Op dat punt is een gecontroleerde oplossing vooruit of een herbouw veiliger dan herhaaldelijk downgraden.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.