Hoe u Home Assistant veilig terugzet na een incompatibele release

Rol 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 rollback begint vóór de eerste reparatiepoging: bewaar de mislukte toestand na de update, bepaal de laatst bekende goed werkende versie en back-up, en ga na of de incompatibiliteit wordt veroorzaakt door Core, een aangepaste integratie, een add-on of een externe database. Een rollback is pas geslaagd wanneer de vorige runtime de herstelde toestand kan lezen en de oorspronkelijke huishoudelijke functies weer werken. Een versiewijziging en een gegevensrollback vormen samen één herstelbewerking, niet twee losstaande knoppen.

Bewaar de mislukte toestand voordat je probeert te downgraden

Overschrijf niet de enige kopie van de configuratie na de update terwijl je experimenteert. Bewaar de huidige configuratie, logboeken, versienummers, database locatie en de exacte functie die defect raakte. Die kopie kan nieuwe wijzigingen bevatten die na de laatste goede back-up zijn gemaakt, evenals bewijsmateriaal dat later nodig is om de incompatibiliteit te begrijpen.

Een restore-regressie uit 2026 liet zien dat zelfs een ogenschijnlijk geslaagde back-upherstelactie de runtime op de verkeerde versie kan laten staan wanneer het omliggende Supervisor-gedrag defect is. Het verslag over het herstellen van een back-up en het terugzetten van de Core-versie is een goede reden om na het herstellen de daadwerkelijke versie te controleren in plaats van het voltooiingsbericht te vertrouwen.

Stop met het aanbrengen van configuratiewijzigingen totdat het herstelpad bekend is. Als de update één optionele aangepaste component heeft beschadigd terwijl de rest van Home Assistant stabiel is, kan het uitschakelen van die component veiliger zijn dan een volledige rollback. Als Core niet kan starten, de database niet kan worden geladen of essentiële automatiseringen onbruikbaar zijn, ga dan over op het gecombineerde herstelpad voor runtime en toestand.

Kies een herstelpunt van vóór de incompatibele release

Bepaal welke back-up als laatste is gemaakt terwijl de oudere Home Assistant-versie correct werkte. Controleer het tijdstip ervan aan de hand van belangrijke wijzigingen in automatiseringen, gebruikers, dashboards of geschiedenis die je bereid bent te verliezen. Het herstelpunt is een afweging: het herstelt de compatibiliteit door de persistente toestand terug te brengen in de tijd.

De richtlijn van ZimaSpace om appgegevens vóór een update als momentopname vast te leggen is de preventieve versie van dezelfde regel: een rollback van de runtime verloopt het schoonst wanneer er van vóór het moment waarop de nieuwe software voor het eerst productiegegevens beschreef een bekende, goed werkende kopie van de toestand bestaat.

Als er geen betrouwbare back-up van vóór de update bestaat, maak er dan niet alsnog een door de al gemigreerde database te kopiëren en die te combineren met een oude Core-image. Bewaar de huidige toestand en onderzoek een oplossing waarbij je vooruitgaat of een gecontroleerde herbouw uitvoert. Een rollback zonder compatibele kopie van de toestand kan één incompatibele functie veranderen in problemen met Recorder, geschiedenis of het register.

Herstel de runtime en persistente toestand als een bij elkaar horend paar

Gebruik voor Home Assistant OS of een beheerde installatie het ondersteunde herstelpad dat het geselecteerde herstelpunt terugzet, en controleer of de bedoelde Core-versie daadwerkelijk start. Bij containerinstallaties is het terugzetten van de image slechts de helft van de handeling als de nieuwere release persistente gegevens heeft gewijzigd; herstel ook de bijbehorende configuratiekopie van vóór de update.

Een Home Assistant Core-issue over downgraden van 2025.4 naar 2025.3 documenteerde dat Recorder, geschiedenis en gerelateerde integraties faalden wanneer de oudere runtime een nieuwere databasestructuur tegenkwam. In de reactie van de maintainer staat expliciet dat een rollback afhankelijk is van het herstellen van een back-up, en niet van een procedure om een database ter plaatse te downgraden.

Herstel externe databases en afhankelijke services alleen naar compatibele versies wanneer Home Assistant ze niet zelf beheert via de back-up. Zet niet blind elke container terug. MQTT, proxy's en radio's kunnen gezond zijn en ongewijzigd blijven; richt de rollback op componenten waarvan de versie of het contract voor de toestand daadwerkelijk is gewijzigd.

Featured

ZimaCube 2 Persoonlijke Cloud Home NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

Valideer de oorspronkelijke fout voordat je automatische updates weer inschakelt

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

Bewaar de kopie van de mislukte toestand en de updateaantekeningen totdat de volgende release of oplossing is getest. Als een aangepaste integratie de incompatibiliteit veroorzaakte, controleer dan welke versies die integratie ondersteunt vóór de volgende Core-update. Als de rollback zelf mislukt, wissel dan niet herhaaldelijk van versie tegen dezelfde veranderlijke database; keer terug naar het schone herstelpunt of ga over op een herbouw met selectief herstel.

De test is geslaagd wanneer de oude versie en de herstelde toestand stabiel blijven tijdens normaal gebruik en na een herstart, en de oorspronkelijke fout verdwenen is. Schakel hulp in wanneer de back-up niet kan worden hersteld, de oudere runtime de toestand nog steeds niet kan lezen of essentiële gegevens geen compatibel herstelpunt hebben. Op dat punt is een gecontroleerde oplossing waarbij je vooruitgaat of een herbouw veiliger dan herhaalde downgradepogingen.