So verhindern Sie, dass Home-Assistant-Backups einen inkonsistenten Datenbankzustand erfassen

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.

Verhindere inkonsistente Home-Assistant-Backups, indem du die Anwendung den Zustand der aktiven Datenbank koordinieren lässt oder vor einer rohen Dateisystemkopie Schreibvorgänge stoppst.

Riskant ist nicht allein das „Backup, während Home Assistant läuft“, sondern eine Kopiermethode, die zusammengehörige Datenbank- und Anwendungsdateien zu unterschiedlichen Zeitpunkten erfasst, ohne ihren Transaktionsstatus zu kennen. Integrierte Backups können die Komponenten von Home Assistant koordinieren, ein allgemeines rsync- oder Snapshot-Tool möglicherweise nicht. Lege fest, welcher Mechanismus für die Konsistenz zuständig ist, vermeide überlappende datenbankintensive Aufgaben, behalte das letzte funktionierende Backup und überprüfe jede Richtlinie durch eine isolierte Wiederherstellung.

Behandle eine aktive SQLite-Datenbank nicht wie eine gewöhnliche statische Datei

Home-Assistant-Recorder kann Daten schreiben, während ein allgemeiner Backup-Prozess das Konfigurationsverzeichnis kopiert. Bei SQLite kann der bestätigte Datenbankzustand die Hauptdatenbank und Journal- oder WAL-Dateien umfassen. Werden diese zu unterschiedlichen Zeitpunkten erfasst, kann eine unvollständige oder nicht wiederherstellbare Kopie entstehen, obwohl jeder Dateiname im Archiv vorhanden ist.

Ein SQLite-Backup-Test mit aktiver Datenbank zeigte, dass beim Kopieren nur der Hauptdatenbankdatei unbemerkt bestätigte Datensätze fehlen konnten, die noch im WAL vorhanden waren, obwohl die kopierte Datenbank eine Integritätsprüfung bestand. Dieser Fehler beim Kopieren einer WAL-gestützten Datenbank ist der Grund, warum eine rohe Dateikopie einen datenbankgestützten Snapshot verwenden oder erst nach dem sauberen Anhalten der Datenbank erfolgen sollte.

Das bedeutet nicht, dass Home Assistant für ein Backup immer heruntergefahren werden muss. Der Backup-Mechanismus muss jedoch wissen, wie ein konsistenter Wiederherstellungspunkt erstellt wird. Verwende für eine laufende Installation das integrierte Home-Assistant-Backup. Auf gestoppte Dateisystemkopien solltest du Migrationen, Offline-Archivierung oder externe Tools ohne anwendungsspezifische Integration beschränken.

Vermeide konkurrierende Backup- oder Wartungsaufgaben im selben Zeitfenster

Auch bei einem anwendungsspezifischen Backup kann die Datenbank möglicherweise nicht vorbereitet werden, wenn ein anderer Prozess Sperren hält oder der Speicherpfad durch ungewöhnliche Wartungsaktivitäten stark beansprucht wird. Plane nicht einfach ein zweites Add-on-Backup, Datenbankwartung, NAS-Snapshot und Home-Assistant-Backup für dieselbe Minute ein, nur weil es im Haus ruhig ist.

Bei echten fehlgeschlagenen Home-Assistant-Backups werden Fehler bei der Vorbereitung der Datenbanksperre gemeldet. Ein Nutzer führte einen Konflikt auf ein anderes Backup-Add-on zurück. Das ist ein Warnsignal: Überlappende Tools sollten zeitlich getrennt werden, und das Anwendungsprotokoll sollte bestätigen, dass die Vorbereitungsphase des Backups abgeschlossen ist.

Staffeln Sie die Wartungsfenster und halten Sie die erwartete Dauer fest. Wenn eine Sicherung regelmäßig auf Recorder wartet, ermitteln Sie zunächst, welcher Prozess die Sperre hält, oder prüfen Sie den Zustand der Datenbank. Erhöhen Sie Zeitüberschreitungen nicht blind und führen Sie nicht mehrere Kopien parallel aus; zusätzliche Sicherungsaufträge können genau die Konkurrenz um Ressourcen verstärken, die Sie vermeiden möchten.

Bei direkten Kopien des Dateisystems Home Assistant in einen konsistenten Zustand versetzen und den gesamten Datenbestand sichern

Wenn Ihre Richtlinie eine direkte Kopie des Konfigurationsverzeichnisses vorschreibt, stoppen Sie Home Assistant vor dem Kopieren ordnungsgemäß, prüfen Sie, ob der Prozess keine Schreibvorgänge mehr ausführt, und kopieren Sie den gesamten erforderlichen Datenbestand, statt nur die Hauptdatenbankdatei auszuwählen. Sichern Sie externe Datenbanken jeweils mit einem eigenen Konsistenzverfahren.

Der bestehende Vergleich von ZimaSpace zwischen einer Home-Assistant-Sicherung im laufenden Betrieb und bei gestopptem Dienst zieht dieselbe Grenze: Eine anwendungsbewusste Live-Sicherung und das direkte Kopieren des Dateisystems sind unterschiedliche Verfahren und sollten nicht zu einer einzigen Regel vermischt werden.

Starten Sie den Dienst nach dem Kopieren neu und prüfen Sie, ob Recorder normal funktioniert. Wenn das Sicherungsziel ein Netzwerkspeicher ist, prüfen Sie außerdem, ob alle Dateien vollständig übertragen wurden, bevor die Netzwerkfreigabe getrennt wurde. Eine unterbrochene Kopie bei gestopptem Dienst ist nur insofern konsistent, als ihre Quelle währenddessen unverändert blieb; sie ist dennoch kein vollständiger Wiederherstellungspunkt.

Single board computer zimaboard2

Vertrauen Sie der Sicherung erst, wenn eine isolierte Wiederherstellung erfolgreich ist

Erstellen Sie eine temporäre Home-Assistant-Instanz oder ein Wiederherstellungsziel und spielen Sie die Sicherungskandidatin ein, ohne veränderliche Dateien aus der Produktionsumgebung zu verwenden. Prüfen Sie bestehende Benutzer, Verlaufsdaten, Dashboards, Integrationen, Automatisierungsdefinitionen und mindestens einen Neustart. Halten Sie die Wiederherstellungsdauer und alle erforderlichen manuellen Korrekturen fest, um die Instanz nutzbar zu machen.

Eine auf Home Assistant Core 2026.7.2 beschränkte Regression führte dazu, dass Recorder während der Vorbereitungsphase vor der Sicherung beim WAL-Checkpoint fehlschlug. Anschließend lief der Zeitgeber des Sicherungsmanagers ab, während dieser auf die Datenbanksperre wartete. Dieses Fehlersignal vor der Sicherung sollte nur als Beleg für den betroffenen Ablauf und als fehlgeschlagener Wiederherstellungspunkt betrachtet werden – nicht als Beweis dafür, dass jede Zeitüberschreitung beim Warten auf eine Sperre dieselbe Ursache hat.

Bestehen Sie den Test, wenn jeweils nur ein Sicherungsmechanismus die Konsistenz gewährleistet, die Datenbankvorbereitung abgeschlossen wird, die letzte bekannte funktionierende Kopie erhalten bleibt und eine Wiederherstellung Benutzer, Verlauf, Einstellungen und das normale Neustartverhalten reproduziert. Schlägt der Wiederherstellungstest fehl, sichern Sie die Belege und erstellen Sie eine neue unterstützte Sicherung oder eine kontrollierte Kopie bei gestopptem Dienst, bevor Sie ältere Wiederherstellungspunkte löschen.

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.