Home Assistant sollte nur dann neu aufgebaut werden, wenn der aktuelle persistente Zustand keine vertrauenswürdige Wiederherstellungsquelle mehr ist und eine bekannte funktionierende Sicherung die Installation nicht wieder in Betrieb nehmen kann. Die meisten Fehler sollten zunächst als Laufzeit-, Integrations-, Konfigurations-, Datenbank-, Speicher- oder Netzwerkprobleme eingeordnet und auf der jeweils kleinsten betroffenen Ebene behoben werden.
Eine Neuinstallation ist nicht automatisch ein vollständiger Neuaufbau. Beim Ersetzen eines Container-Images kann /config unverändert bleiben, während ein echter Neuaufbau einen frischen Anwendungszustand erstellt und voraussetzt, dass Integrationen, Geräte, Dashboards, Helfer und Automatisierungen wiederhergestellt oder neu erstellt werden. Treffen Sie diese Entscheidung anhand des Zustands der Daten und nicht aus Frustration über das aktuelle Symptom.
Verwenden Sie drei verschiedene Maßnahmen: Reparieren, Wiederherstellen, Neuaufbauen
Beim Reparieren bleiben die aktuelle Konfiguration und der bestehende Zustand erhalten, während die fehlerhafte Komponente behoben wird. Beim Wiederherstellen wird ein beschädigter oder inkompatibler Zustand durch eine bekannte funktionierende Sicherung ersetzt. Beim Neuaufbau wird mit einer sauberen Home-Assistant-Installation begonnen und anschließend nur der Zustand importiert oder neu erstellt, dem Sie bewusst vertrauen.
Diese Unterscheidung verhindert, dass aus einem Container- oder Paketproblem ein unnötiger Datenverlust wird. Wenn die aktuellen Benutzer, Bereiche, Geräte und Automatisierungen noch vorhanden sind, kann eine frische Installation mehr funktionierende Informationen zerstören, als sie repariert.
Notieren Sie vor Änderungen an Dateien, welche der drei Maßnahmen Sie durchführen. Diese einfache Kennzeichnung erschwert es, versehentlich von einer Reparatur zu einem destruktiven Zurücksetzen überzugehen.
Reparieren Sie zuerst, wenn der persistente Zustand weiterhin konsistent ist
Eine Reparatur ist angebracht, wenn Home Assistant die erwartete Instanz öffnet, das Konfigurationsverzeichnis gefüllt ist und sich der Fehler einer bestimmten Integration, YAML-Änderung, benutzerdefinierten Komponente, Datenbankdatei, Einbindung oder Laufzeiteinstellung zuordnen lässt.
Der abgesicherte Modus und der Wiederherstellungsmodus existieren genau deshalb, weil sich viele Startfehler eingrenzen lassen, ohne die Konfiguration aufzugeben. Ein aktueller Wiederherstellungsleitfaden empfiehlt, den genauen Startfehler zu lesen, den abgesicherten Modus zur Isolierung benutzerdefinierten Codes zu verwenden und den Wiederherstellungsmodus als minimalen Reparaturweg vor einem Neuaufbau einzusetzen.
Deaktivieren oder aktualisieren Sie jeweils nur eine benutzerdefinierte Integration, korrigieren Sie einen ungültigen Konfigurationseintrag, reparieren Sie den Speicherpfad oder setzen Sie die Laufzeitversion zurück und testen Sie anschließend erneut. Setzen Sie nicht die gesamte Installation zurück, solange sich der Fehler noch klar eingrenzen lässt.
Reparieren Sie die Datenbank nur, wenn sich das Speichern der Historie lohnt
Eine beschädigte Recorder-Datenbank kann schwerwiegend wirken, weil die Protokolle mit Datenbankfehlern gefüllt werden. Die Recorder-Datenbank ist jedoch nicht dasselbe wie die vollständige Home-Assistant-Konfiguration. Wenn die aktuelle Konfiguration und die Integrationen intakt sind, kann eine neue Verlaufsdatenbank manchmal weniger riskant sein als ein vollständiger Neuaufbau der Anwendung.
Wenn die Historie wichtig ist, zeigt eine praktische Anleitung zur Wiederherstellung, wie Home Assistant beendet und die Wiederherstellungswerkzeuge von SQLite verwendet werden, um eine beschädigte Home-Assistant-Datenbank in einer neuen Datei zu rekonstruieren.
Arbeiten Sie ausschließlich mit Kopien, bewahren Sie die ursprüngliche beschädigte Datenbank auf und rechnen Sie damit, dass die Wiederherstellung unvollständig sein kann. Eine fehlgeschlagene Reparatur der Historie sollte kein Grund werden, funktionierende Automatisierungen und Integrationen zu verwerfen.
Stellen Sie wieder her, wenn eine bekannte funktionierende Sicherung sicherer ist als eine weitere Reparatur
Stellen Sie wieder her, wenn der Fehler nach einer erkennbaren Aktualisierung oder Änderung begonnen hat und Sie über eine getestete Sicherung aus der Zeit vor dieser Änderung verfügen. Das ist oft schneller und sicherer, als Dutzende migrierte oder teilweise geänderte Dateien manuell zurückzusetzen.
Ein seit Langem bestehender Home-Assistant-Leitfaden zur Wiederherstellung empfiehlt, zunächst die Fehlerursache zu beheben und anschließend eine Sicherung wiederherzustellen, die vom ausgefallenen System getrennt kopiert wurde. Wenn das fehlerhafte Netzteil, das Speicherproblem, die falsche Einbindung oder die inkompatible Laufzeit nicht entfernt wird, wird durch die Wiederherstellung lediglich derselbe Vorfall erneut erzeugt.
Bewahren Sie den beschädigten Zustand auf, bis das wiederhergestellte System erfolgreich geprüft wurde. Er kann aktuelle Automatisierungen, Geheimnisse oder Konfigurationsänderungen enthalten, die verglichen oder selektiv übernommen werden müssen.
Bauen Sie neu auf, wenn Zustand und Wiederherstellungsquellen nicht mehr vertrauenswürdig sind
Ein sauberer Neuaufbau wird sinnvoll, wenn das Konfigurationsverzeichnis fehlt oder umfangreich beschädigt ist, mehrere Sicherungen die Wiederherstellungstests nicht bestehen, die Laufzeitdefinition unbekannt ist oder wiederholte Reparaturen die Installation in einen undokumentierten Zustand versetzt haben, der sich nicht reproduzieren lässt.
Ein Neuaufbau kann auch die sauberere Lösung sein, wenn Sie eine schlecht strukturierte Bereitstellung verlassen möchten – beispielsweise wenn wichtige Konfigurationen in einem kurzlebigen Container eingeschlossen sind –, vorausgesetzt, Sie exportieren zuvor jedes vertrauenswürdige Stück Zustand, das sich noch sichern lässt.
Der lokale Automatisierungsleitfaden von ZimaSpace betont die Wiederherstellbarkeit als zentrale Anforderung an eine Smart-Home-Plattform. Ein Neuaufbau ist erst dann erfolgreich, wenn sich die neue Installation leichter sichern, wiederherstellen und betreiben lässt als der aufgegebene Zustand.
Verwenden Sie vor dem Löschen des alten Zustands eine Entscheidungstabelle
| Bedingung | Bevorzugte Maßnahme |
|---|---|
| Einzelner Integrations- oder Konfigurationsfehler | Reparieren |
| Aktualisierung der Laufzeit oder des Images fehlgeschlagen, Konfiguration intakt | Laufzeit reparieren oder zurücksetzen |
| Datenbank beschädigt, Konfiguration intakt | Datenbank reparieren oder ersetzen |
| Bekannte funktionierende Sicherung liegt vor dem umfassenden Schaden | Wiederherstellen |
| Konfiguration und Sicherungen sind nicht vertrauenswürdig oder nicht reproduzierbar | Neuaufbauen |
Löschen Sie die alte Konfiguration, Datenbank oder Sicherungssammlung erst, wenn der gewählte Weg einen Neustart und einen normalen Nutzungszyklus im Haushalt bestanden hat.
FAQ
Gilt die Neuinstallation des Home-Assistant-Containers als Neuaufbau?
Nein. Wenn der Ersatzcontainer erneut dasselbe persistente /config-Verzeichnis einbindet, haben Sie die Laufzeit ersetzt, aber den Zustand derselben Installation beibehalten. Ein Neuaufbau beginnt mit einem frischen Zustand oder gibt den alten Zustand bewusst auf.
Sollte ich Home Assistant neu aufbauen, weil die Recorder-Datenbank beschädigt ist?
Normalerweise nicht. Der Verlauf des Recorders kann unabhängig vom restlichen Home Assistant repariert, wiederhergestellt oder ersetzt werden. Bauen Sie die gesamte Installation nur dann neu auf, wenn nicht nur die Historie, sondern auch die Konfiguration und der Wiederherstellungszustand nicht mehr vertrauenswürdig sind.
Support & Tipps
Mehr zum Lesen

Solltest du Home Assistant im laufenden Betrieb sichern oder zuerst den Dienst stoppen?
Integrierte Home-Assistant-Backups können im laufenden Betrieb ausgeführt werden; einfache Dateisystemkopien sollten Home Assistant anhalten oder in einen Ruhezustand versetzen, sofern die Datenbank nicht konsistent...

Warum läuft ein Home-Assistant-Server während der Leerlaufzeiten heiß oder laut?
Gleiche Lüfter- oder Temperaturspitzen in Home Assistant zunächst mit Recorder, Backups, Integrationen und parallel ausgeführten Aufgaben ab, bevor du die Kühlung oder CPU-Limits änderst.

Wie viel freier Speicherplatz sollte Home Assistant für Hintergrundaufgaben bereithalten?
Bemessen Sie den freien Speicherplatz für Home Assistant anhand der Recorder-Datenbank, des Backup-Wachstums, Wartungsspitzen und Wiederherstellungsvorgängen – nicht nach einem pauschalen Prozentsatz.

