So führen Sie Home Assistant nach einer inkompatiblen Version sicher zurück

Eva Wong

IceWhale author

Eva Wong ist die Technische Redakteurin und und leidenschaftliche Tüftlerin bei ZimaSpace. Eine lebenslange Geek mit einer Leidenschaft für Homelabs und Open-Source-Software, sie spezialisiert sich darauf, komplexe technische Konzepte in zugängliche, praktische Anleitungenzu übersetzen. Eva ist der Meinung, dass Self-Hosting Spaß machen und nicht einschüchternd sein sollte. Durch ihre Tutorials befähigt sie die Community, Hardware-Setups zu entmystifizieren, vom Bau ihres ersten NAS bis hin zur Beherrschung von Docker-Containern.

How to Roll Back Home Assistant Safely After an Incompatible Release - Zima Store Online

Setze Home Assistant mithilfe eines Wiederherstellungspunkts vor dem Update zurück, der zur älteren Core-Version passt. Gehe nicht davon aus, dass das Starten einer alten Laufzeitumgebung neuere Migrationen des persistenten Zustands rückgängig macht.

Der sicherste Rollback beginnt vor dem ersten Reparaturversuch: Bewahre den fehlgeschlagenen Zustand nach dem Update auf, ermittle die zuletzt bekannte funktionierende Version und Sicherung 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.

Bewahre den fehlgeschlagenen Zustand auf, bevor du ein Downgrade versuchst

Überschreibe nicht die einzige Kopie der Konfiguration nach dem Update, während du experimentierst. Sichere die aktuelle Konfiguration, Protokolle, Versionsnummern, den Speicherort der Datenbank und die genaue Funktion, die ausgefallen ist. Diese Kopie kann neue Änderungen enthalten, die nach der letzten funktionierenden Sicherung vorgenommen wurden, sowie Hinweise, die später zum Verständnis der Inkompatibilität benötigt werden.

Eine Restore-Regression aus dem Jahr 2026 hat gezeigt, dass eine scheinbar erfolgreiche Wiederherstellung aus einer Sicherung die Laufzeitumgebung auf der falschen Version belassen kann, wenn das Verhalten des umgebenden Supervisors fehlerhaft ist. Der Bericht zu der Wiederherstellung einer Sicherung und dem Rollback der Core-Version ist ein guter Grund, die tatsächliche Version nach der Wiederherstellung zu überprüfen, statt der Abschlussmeldung zu vertrauen.

Beende alle Konfigurationsänderungen, bis der Wiederherstellungspfad feststeht. Wenn das Update nur eine optionale benutzerdefinierte Komponente beschädigt hat und der restliche Teil von Home Assistant stabil läuft, kann das Deaktivieren dieser Komponente sicherer sein als ein vollständiger Rollback. Wenn Core nicht starten kann, die Datenbank nicht geladen wird oder wichtige Automatisierungen unbrauchbar sind, wechsle zum gekoppelten Wiederherstellungspfad für Laufzeit und Zustand.

Wähle einen Wiederherstellungspunkt vor der inkompatiblen Version

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

Der Leitfaden von ZimaSpace zum Erstellen eines Snapshots der App-Daten vor einem Update ist die vorbeugende Variante derselben Regel: Ein Rollback der Laufzeitumgebung ist am saubersten, wenn eine bekannte funktionierende Zustandskopie aus der Zeit vor dem ersten Schreiben der neuen Software in die Produktivdaten vorhanden ist.

Wenn keine vertrauenswürdige Sicherung vor dem Update existiert, erstelle keine vermeintliche Sicherung, indem du die bereits migrierte Datenbank kopierst und mit einem alten Core-Image kombinierst. Bewahre den aktuellen Zustand auf und untersuche eine Vorwärtslösung oder einen kontrollierten Neuaufbau. Ein Rollback ohne kompatible Zustandskopie kann aus einer einzelnen inkompatiblen Funktion Fehler bei Recorder, Verlauf oder Registrys machen.

Stelle Laufzeitumgebung und persistenten Zustand als zusammengehöriges Paar wieder her

Verwende bei Home Assistant OS oder einer verwalteten Installation den unterstützten Wiederherstellungspfad, der den ausgewählten Wiederherstellungspunkt zurückbringt, und überprüfe, dass tatsächlich die vorgesehene Core-Version startet. Bei Container-Installationen ist das Zurücksetzen des Images nur die Hälfte des Vorgangs, wenn die neuere Version persistente Daten geändert hat; stelle zusätzlich die entsprechende Konfigurationskopie vor dem Update wieder her.

Ein Home-Assistant-Core-Problem zum Downgrade von 2025.4 auf 2025.3 dokumentierte Ausfälle von Recorder, Verlauf und verwandten Integrationen, wenn die ältere Laufzeit auf eine neuere Datenbankstruktur traf. Die Antwort des Maintainers stellt ausdrücklich fest, dass ein Rollback die Wiederherstellung einer Sicherung voraussetzt und kein Verfahren zum direkten Downgrade der Datenbank existiert.

Stelle externe Datenbanken und abhängige Dienste nur dann auf kompatible Stände zurück, wenn die Home-Assistant-Sicherung diese nicht umfasst. Setze nicht blind jeden Container zurück. MQTT, Proxys und Funkgeräte können fehlerfrei funktionieren und unverändert bleiben. Konzentriere den Rollback auf Komponenten, deren Versions- oder Zustandsvertrag tatsächlich geändert wurde.

Featured

ZimaCube 2 Persönliche Cloud Home NAS

ZimaCube2

Überprüfe den ursprünglichen Fehler, bevor du automatische Updates wieder aktivierst

Bestätige nach dem Rollback die laufende Core-Version, die Anmeldung, Recorder/Verlauf, wichtige Integrationen, Automatisierungen, Dashboards und jeweils ein Gerät aus jedem kritischen Protokoll. Wiederhole die Aktion, die bei der inkompatiblen Version fehlgeschlagen ist, und überprüfe, dass sie nun ohne neue Fehler funktioniert. Starte Home Assistant anschließend neu und führe einmal einen Neustart des Hosts durch.

Bewahre die Kopie des fehlgeschlagenen Zustands und die Update-Notizen auf, bis die nächste Version oder Fehlerbehebung getestet wurde. Wenn eine benutzerdefinierte Integration die Inkompatibilität verursacht hat, prüfe vor dem nächsten Core-Update deren unterstützte Versionen. Wenn der Rollback selbst fehlschlägt, wechsle nicht wiederholt zwischen Versionen und verwende dabei dieselbe veränderliche Datenbank. Kehre stattdessen zum sauberen Wiederherstellungspunkt zurück oder führe einen Neuaufbau mit selektiver Wiederherstellung durch.

Der Vorgang gilt als erfolgreich, wenn die alte Version und der wiederhergestellte Zustand während der normalen Nutzung und nach einem Neustart stabil bleiben und der ursprüngliche Fehler verschwunden ist. Eskaliere, wenn die Sicherung nicht wiederhergestellt werden kann, die ältere Laufzeit den Zustand weiterhin nicht lesen kann oder für kritische Daten kein kompatibler Wiederherstellungspunkt existiert. Ab diesem Punkt ist eine kontrollierte Vorwärtslösung oder ein Neuaufbau sicherer als wiederholte Downgrade-Versuche.