So verhindern Sie den Verlust der Home-Assistant-Konfiguration bei Upgrades

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 Prevent Home Assistant Configuration Loss During Upgrades - Zima Store Online

Verhindern Sie den Verlust der Home-Assistant-Konfiguration, indem Sie das integrierte Backup-System zum primären Wiederherstellungsweg machen und die Laufzeitumgebung als austauschbar behandeln. Die Home-Assistant-Version, das Container-Image oder der Host können sich ändern; das Backup, der Verschlüsselungsschlüssel, die Laufzeitdefinition und alle externen Abhängigkeiten müssen weiterhin verfügbar sein, wenn die ursprüngliche Maschine nicht mehr vorhanden ist.

Moderne Home-Assistant-Backups funktionieren über verschiedene Installationstypen hinweg, einschließlich Container. Bewahren Sie eine separate manuelle Kopie des Konfigurationsverzeichnisses auf, wenn dies zusätzlichen Nutzen bietet, aber richten Sie den gesamten Upgrade-Plan nicht auf das manuelle Kopieren von Dateien aus, während Sie den unterstützten Backup- und Wiederherstellungs-Workflow ignorieren.

Beginnen Sie mit einem integrierten Backup, nicht mit einem manuell kopierten YAML-Ordner

Reduzieren Sie „Konfiguration“ nicht auf configuration.yaml. Das unterstützte Backup-System von Home Assistant erfasst den für die Wiederherstellung erforderlichen Anwendungszustand, einschließlich Konfiguration und Datenbankinhalten. Neuere Backup-Workflows unterstützen außerdem Automatisierung, Aufbewahrung und externe Speicherorte.

Die 2025 eingeführte Überarbeitung des Backups ergänzte automatische verschlüsselte Backups, Aufbewahrungskontrollen und externe Backup-Speicherorte. Dadurch ist das integrierte Backup der erste Wiederherstellungsbestand, den Sie vor einem Upgrade überprüfen sollten, statt sich auf eine unvollständige manuelle Kopie zu verlassen.

Dokumentieren Sie dennoch das Konfigurationsstammverzeichnis, die Datenbankauswahl, Verweise auf Geheimnisse, benutzerdefinierte Komponenten, SSL-Material sowie alle externen Dateien oder Dienste, die eine Integration benötigt. Ein Backup kann den Home-Assistant-Zustand wiederherstellen, dokumentiert jedoch nicht automatisch jedes USB-Gerät, jeden Netzwerkpfad, jeden Datenbank-Host oder jeden Containerparameter in der Umgebung.

Halten Sie die Container-Persistenz und Laufzeiteinstellungen eindeutig fest

Prüfen Sie bei Docker den Bind-Mount oder das Volume, dem /config gehört, und bewahren Sie die Compose- oder Run-Definition auf, mit der Netzwerkmodus, Gerätezuordnungen, Zeitzone, Berechtigungen und externe Dienste erneut eingerichtet werden. Das Container-Dateisystem selbst sollte als ersetzbar betrachtet werden.

Eine Diskussion zu Home-Assistant-Docker-Backups zeigt den Fehlerfall deutlich: Wenn Benutzer nur eine Datei statt des vollständigen Konfigurationsverzeichnisses einbinden, kann wichtiger Zustand im Container eingeschlossen bleiben und verschwinden, sobald diese Laufzeitumgebung ersetzt wird.

Überprüfen Sie den Host-Mount vor dem Upgrade und bewahren Sie die Laufzeitdefinition zusammen mit dem Backup auf. Die Wiederherstellung geht deutlich schneller, wenn sowohl der Anwendungszustand als auch die erforderlichen Anweisungen zum Bereitstellen von Funkgeräten, Ports, Netzwerken und Speicher bereits bekannt sind.

Verschieben Sie mindestens ein verschlüsseltes Backup vom Host

Ein Backup auf derselben SSD schützt vor einigen Konfigurationsfehlern, jedoch nicht vor dem Verlust des Hosts, Dateisystembeschädigung, Diebstahl oder einem Ausfall des Speichergeräts. Bewahren Sie mindestens eine Wiederherstellungskopie auf einem NAS, einem anderen Computer oder an einem entfernten Backup-Speicherort auf, dessen Zugriff nicht vom ausgefallenen Home-Assistant-Host abhängt.

Bewahren Sie den Backup-Verschlüsselungsschlüssel oder das Notfall-Kit ebenfalls außerhalb von Home Assistant auf. Home Assistant 2026.4 verwendet für neue verschlüsselte Backups das geprüfte SecureTar-v3-Format mit stärkerer moderner Verschlüsselung. Das verbessert die Backup-Sicherheit, macht den Umgang mit dem Schlüssel jedoch zu einem ausdrücklichen Bestandteil der Wiederherstellbarkeit.

Versionieren Sie das Backup, statt immer dieselbe Datei zu überschreiben. Ein Upgrade kann erst Tage später ein Problem offenlegen, und der neueste Wiederherstellungspunkt enthält möglicherweise bereits den migrierten oder beschädigten Zustand, dem Sie entkommen möchten.

Featured

ZimaCube 2 Persönliche Cloud Home NAS

ZimaCube2

Das Backup ersetzt nicht Ihre Laufzeitdefinition

Die Konfiguration allein stellt möglicherweise keine USB-Funkgeräte, Host-Netzwerke, Zeitzone, Geräteweitergabe, Datenbankdienste, MQTT- oder Reverse-Proxy-Beziehungen wieder her. Bewahren Sie die Compose-Datei, die Richtlinie für Image-Versionen, Umgebungsvariablen, Host-Pfade, Gerätezuordnungen und Dienstabhängigkeiten auf, die zum erneuten Erstellen der Laufzeitumgebung erforderlich sind.

Speichern Sie keine Klartext-Geheimnisse in einem öffentlichen Repository, nur um die Compose-Datei zu versionieren. Bewahren Sie geheime Werte an einem geschützten Ort auf und dokumentieren Sie lediglich, woher der Wiederherstellungsprozess sie bezieht.

Der Home-Assistant-Bereitstellungsleitfaden für ZimaBoard von ZimaSpace bietet hilfreichen Kontext für die Trennung der Home-Server-Plattform vom Anwendungszustand, der zukünftige Änderungen an der Bereitstellung überdauern muss.

Führen Sie einen Wiederherstellungstest durch, bevor das Upgrade zum Notfall wird

Ein Backup ist nicht allein deshalb bewiesen, weil das Archiv vorhanden ist. Stellen Sie es auf einem isolierten Ziel oder in einem temporären Container wieder her, verbinden Sie nach Möglichkeit repräsentative Geräte und Pfade erneut und bestätigen Sie, dass das System mit Benutzern, Dashboards, Integrationen, Automatisierungen, Helfern und dem erwarteten Zustand zurückkehrt.

Nutzen Sie den Test, um fehlende Passwörter, veraltete Host-Pfade, nicht dokumentierte Gerätezuordnungen und übergroße Datenbanken zu entdecken, solange das Produktionssystem noch funktioniert. Dokumentieren Sie die Wiederherstellungsschritte nach dem erfolgreichen Test; Erinnerung ist kein Wiederherstellungsplan.

Erstellen Sie unmittelbar vor dem Upgrade einen aktuellen Wiederherstellungspunkt, notieren Sie die derzeitige Home-Assistant-Version und das Container-Image und prüfen Sie die Änderungen des Releases, die Ihre Integrationen betreffen. Halten Sie die vorherige Laufzeitumgebung verfügbar, bis die aktualisierte Instanz sowohl eine normale Nutzungsdauer als auch einen Neustart überstanden hat.

Verwenden Sie eine vierteilige Sicherheitsprüfung für Upgrades

Wiederherstellungsbestandteil	Was er schützt	Folge bei fehlendem Bestandteil
Integriertes Backup	Home-Assistant-Konfiguration und wiederherstellbarer Anwendungszustand	Kein unterstützter Wiederherstellungspunkt
Verschlüsselungsschlüssel / Notfall-Kit	Zugriff auf geschützte Backups	Das Backup existiert, kann aber nicht geöffnet werden
Laufzeitdefinition	Mounts, Geräte, Netzwerk und Umgebung	Korrekt wiederhergestellter Zustand, aber kein funktionierender Dienstzugriff
Externe Kopie + Wiederherstellungstest	Host-Ausfall und Gültigkeit des Verfahrens	Die Wiederherstellung verschwindet mit der Produktion oder schlägt im Ernstfall fehl

Führen Sie das Upgrade erst durch, wenn alle vier Bestandteile vorhanden und gesichert sind. Eine manuelle Kopie des Konfigurationsverzeichnisses kann als zusätzliche Schutzschicht bestehen bleiben, aber der primäre Wiederherstellungsplan sollte aus einem unterstützten Backup bestehen, das Sie entschlüsseln und zusammen mit einer dokumentierten Laufzeitumgebung wiederherstellen können.