So setzen Sie Home Assistant nach einem inkompatiblen Release sicher zurück

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Setze Home Assistant mit einem Wiederherstellungspunkt vor dem Update zurück, der zur älteren Core-Version passt; gehe nicht davon aus, dass das Starten einer älteren Laufzeit neuere Migrationen des persistenten Zustands rückgängig macht.

Das sicherste Rollback beginnt vor dem ersten Reparaturversuch: Sichere den fehlerhaften Zustand nach dem Update, ermittle die letzte bekanntermaßen funktionierende Version und das entsprechende Backup und entscheide, ob die Inkompatibilität Core, eine benutzerdefinierte Integration, ein Add-on oder eine externe Datenbank betrifft. Ein Rollback ist nur dann erfolgreich, wenn die vorherige Laufzeit den wiederhergestellten Zustand lesen kann und die ursprünglichen Funktionen im Haushalt wieder funktionieren. Versionsänderung und Daten-Rollback sind ein gemeinsamer Wiederherstellungsvorgang, keine zwei voneinander unabhängigen Schaltflächen.

Sichere den fehlerhaften Zustand, bevor du ein Downgrade versuchst

Überschreibe beim Experimentieren nicht die einzige Kopie der Konfiguration nach dem Update. Sichere die aktuelle Konfiguration, Protokolle, Versionsnummern, den Datenbankpfad und die genaue Funktion, die ausgefallen ist. Diese Kopie kann neue Änderungen enthalten, die nach dem letzten funktionierenden Backup vorgenommen wurden, sowie Hinweise, die später helfen, die Inkompatibilität zu verstehen.

Eine Regression bei der Wiederherstellung im Jahr 2026 zeigte, dass selbst eine scheinbar erfolgreiche Backup-Wiederherstellung die Laufzeit auf der falschen Version belassen kann, wenn das umgebende Supervisor-Verhalten fehlerhaft ist. Der Bericht über die Wiederherstellung eines Backups und das Zurücksetzen der Core-Version ist ein guter Grund, nach der Wiederherstellung die tatsächliche Version zu überprüfen, statt der Abschlussmeldung zu vertrauen.

Nimm keine weiteren Konfigurationsänderungen vor, bis der Wiederherstellungsweg feststeht. Wenn das Update eine optionale benutzerdefinierte Komponente beschädigt hat, während der Rest von Home Assistant stabil läuft, ist es möglicherweise sicherer, diese Komponente zu deaktivieren, statt ein vollständiges Rollback durchzuführen. Wenn Core nicht starten kann, die Datenbank nicht geladen werden kann oder wichtige Automatisierungen unbrauchbar sind, nutze den kombinierten Wiederherstellungsweg für Laufzeit und Zustand.

Wähle einen Wiederherstellungspunkt vor der inkompatiblen Version

Ermittle das letzte Backup, das erstellt wurde, während die ältere Home-Assistant-Version noch ordnungsgemäß lief. Vergleiche den Zeitstempel mit wichtigen Änderungen an Automatisierungen, Benutzern, Dashboards oder dem Verlauf, auf die du verzichten kannst. Der Wiederherstellungspunkt ist ein Kompromiss: Er stellt die Kompatibilität wieder her, indem er den persistenten Zustand zeitlich zurücksetzt.

Die Anleitung von ZimaSpace, vor einem Update einen Snapshot der App-Daten zu erstellen, ist die vorbeugende Umsetzung derselben Regel: Ein Laufzeit-Rollback gelingt am zuverlässigsten, wenn eine bekannte funktionierende Zustandskopie existiert, bevor die neue Software erstmals in die Produktivdaten schreibt.

Wenn kein vertrauenswürdiges Backup von vor dem Update vorhanden ist, erstellen Sie keines, indem Sie die bereits migrierte Datenbank kopieren und mit einem alten Core-Image kombinieren. Bewahren Sie den aktuellen Zustand auf und prüfen Sie eine Fehlerbehebung durch ein Update oder einen kontrollierten Neuaufbau. Ein Rollback ohne kompatible Zustandskopie kann aus einem einzelnen inkompatiblen Feature Fehler im Recorder, Verlauf oder Register machen.

Laufzeitumgebung und persistenten Zustand als zusammengehöriges Paar wiederherstellen

Verwenden Sie bei Home Assistant OS oder einer verwalteten Installation den unterstützten Wiederherstellungsweg, der den ausgewählten Wiederherstellungspunkt zurückspielt, und prüfen Sie, ob tatsächlich die gewünschte Core-Version startet. Bei Container-Installationen reicht es nicht, nur das Image zurückzusetzen, wenn die neuere Version persistente Daten geändert hat. Stellen Sie auch die zugehörige Konfigurationskopie von vor dem Update wieder her.

In einem Home-Assistant-Core-Issue zum Downgrade von 2025.4 auf 2025.3 wurde dokumentiert, dass Recorder, Verlauf und zugehörige Integrationen ausfielen, wenn die ältere Laufzeitumgebung auf eine neuere Datenbankstruktur traf. In der Antwort der Maintainer steht ausdrücklich, dass ein Rollback die Wiederherstellung eines Backups voraussetzt und kein In-Place-Downgrade der Datenbank unterstützt wird.

Stellen Sie externe Datenbanken und abhängige Dienste nur dann auf kompatible Wiederherstellungspunkte zurück, wenn sie nicht im Home-Assistant-Backup enthalten sind. Setzen Sie nicht blind alle Container auf ältere Versionen zurück. MQTT, Proxys und Funkgeräte können einwandfrei funktionieren und unverändert bleiben. Konzentrieren Sie das Rollback auf Komponenten, deren Versions- oder Zustandsvertrag sich tatsächlich geändert hat.

Ursprünglichen Fehler prüfen, bevor automatische Updates wieder aktiviert werden

Prüfen Sie nach dem Rollback die laufende Core-Version, die Anmeldung, Recorder/Verlauf, wichtige Integrationen, Automatisierungen, Dashboards und jeweils ein Gerät aus jedem kritischen Protokoll. Wiederholen Sie die Aktion, die in der inkompatiblen Version fehlgeschlagen ist, und vergewissern Sie sich, dass sie nun ohne neue Fehler funktioniert. Starten Sie anschließend Home Assistant und den Host jeweils einmal neu.

Bewahren Sie die Kopie des fehlerhaften Zustands und die Aktualisierungsnotizen auf, bis die nächste Version oder Fehlerbehebung getestet wurde. Wenn eine benutzerdefinierte Integration die Inkompatibilität verursacht hat, prüfen Sie vor dem nächsten Core-Update, welche Versionen unterstützt werden. Wenn das Rollback selbst fehlschlägt, wechseln Sie nicht wiederholt zwischen Versionen und verwenden Sie dabei dieselbe veränderliche Datenbank. Stellen Sie den sauberen Wiederherstellungspunkt wieder her oder beginnen Sie einen Neuaufbau mit gezielter Wiederherstellung.

Bestanden, wenn die alte Version und der wiederhergestellte Zustand im normalen Betrieb und nach einem Neustart stabil bleiben und der ursprüngliche Fehler behoben ist. Eskalieren Sie, wenn sich das Backup nicht wiederherstellen lässt, die ältere Laufzeitumgebung ihren Zustand weiterhin nicht lesen kann oder es für kritische Daten keinen kompatiblen Wiederherstellungspunkt gibt. An dieser Stelle ist eine kontrollierte Fehlerbehebung durch ein Update oder ein Neuaufbau sicherer als wiederholte Downgrade-Versuche.

Support und Tipps

Mehr zum Lesen

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.