So verschieben Sie Home-Assistant-Daten, ohne Benutzer, Verlauf oder Einstellungen zu verlieren

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.

Verschieben Sie Home Assistant-Daten, indem Sie den vollständigen Anwendungszustand erhalten und die alte Instanz unangetastet lassen, bis die Ersatzinstanz vollständig validiert wurde.

Benutzer und Einstellungen bestehen nicht nur aus den sichtbaren YAML-Dateien, und der Verlauf lässt sich nicht durch das Kopieren eines Dashboards wiederherstellen. Bei einer Migration müssen das Home Assistant-Konfigurationsverzeichnis oder ein unterstütztes Backup, die Recorder-Datenbank, sofern der Verlauf wichtig ist, verborgene Speicherbereiche, Secrets, benutzerdefinierte Komponenten sowie die laufzeitspezifischen Geräte- und Netzwerkzuordnungen erhalten bleiben. Am sichersten ist die folgende Reihenfolge: erfassen, konsistent kopieren, isoliert starten, validieren und erst dann die Quellinstanz außer Betrieb nehmen.

Vor dem Umzug persistente Zustände und externe Abhängigkeiten erfassen

Betrachten Sie bei einer Container-Installation das gesamte eingebundene Home Assistant-Konfigurationsverzeichnis als zentrale Wiederherstellungseinheit, statt einige vertraute Dateien auszuwählen. Verborgene Zustände unter .storage, Authentifizierungsdaten, Integrationsverzeichnisse, Dashboards, Automatisierungen und die standardmäßige Recorder-Datenbank können sich alle in diesem Pfad befinden. Externe MariaDB-Datenbanken, MQTT, Zigbee-Gateways, Secret-Speicher oder NAS-Einbindungen müssen separat aufgeführt werden.

Eine Anleitung zur Migration eines Home Assistant-Containers zeigt, warum das Verschieben des gesamten Konfigurationsverzeichnisses sicherer ist, als den Zustand Datei für Datei neu zusammenzustellen. Außerdem wird betont, dass der alte Container vor dem direkten Kopieren des Dateisystems gestoppt werden muss.

Erstellen Sie ein Manifest mit Quellpfad, Zielpfad, Besitzer-UID/GID, Datenbankpfad, USB- oder seriellen Geräten, Netzwerkmodus, veröffentlichten Ports, externen Diensten und der aktuellen Home Assistant-Version. Wenn eine Abhängigkeit nicht dokumentiert ist, löschen Sie die alte Instanz nicht. Die Migration ist erst dann bereit, wenn der neue Host diese Abhängigkeit anhand der schriftlichen Informationen reproduzieren kann.

Vor dem Kopieren der Daten einen konsistenten Wiederherstellungspunkt erstellen

Verwenden Sie das integrierte Backup oder eine andere anwendungsbewusste Methode, sofern Ihre Installation diese unterstützt. Wenn Sie einen Container direkt kopieren, stoppen Sie Home Assistant, bevor Sie die aktive Konfigurationsdatenbank und zugehörige Dateien kopieren. Bei einer einfachen Live-Kopie können Anwendungsdateien zu unterschiedlichen Zeitpunkten erfasst werden - das ist das Gegenteil einer kontrollierten Migration.

Die umfassende Überarbeitung der Backups in Home Assistant erweiterte die Unterstützung für die Wiederherstellung auf verschiedene Installationsmethoden. Dadurch bildet ein unterstütztes Backup eine zuverlässige Grundlage für die Portierung beim Wechsel der Laufzeitumgebung. Die praktische Lehre aus der Wiederherstellung eines Backups über Installationen hinweg lautet: Die Laufzeitumgebung kann wechseln, während der Anwendungszustand die Kontinuität sichert.

Bewahren Sie zwei Kopien auf: einen unberührten Wiederherstellungspunkt von vor dem Umzug und eine Arbeitskopie für die Migration. Lassen Sie die neue Home-Assistant-Instanz nicht mit der einzigen intakten Quellkopie starten. Wenn das Ziel eine Migration ausführt oder neue Registrierungsdaten schreibt, brauchen Sie weiterhin einen sauberen Rückweg zur alten Version und zum alten Host.

Laufzeitspezifische Hardware- und Netzwerkzuordnungen separat neu einrichten

Anwendungsdaten stellen Host-Gerätepfade nicht automatisch wieder her. Zigbee- oder Z-Wave-USB-Koordinatoren können unter einem anderen Gerätenamen erscheinen, der Bluetooth-Zugriff kann abweichen, Host-Netzwerkeinstellungen können die Erkennung verändern, und externe Datenbanken oder MQTT-Broker können über andere Adressen erreichbar sein. Richten Sie diese Schnittstellen ausdrücklich neu ein, bevor Sie eine nicht verfügbare Integration als Datenverlust einstufen.

Eine unabhängige Anleitung zur Migration von Container zu HAOS zeigt, dass die Wiederherstellung des Home-Assistant-Core-Zustands nicht automatisch Nebendienste wie MQTT, Zigbee2MQTT oder Node-RED neu erstellt. Die zugehörige Migrationsabfolge zur Neuzuordnung von Nebendiensten überprüft außerdem die Kontinuität des Recorder-Verlaufs, den Zugriff auf den USB-Koordinator und einen gestoppten, aber intakten alten Stack als Rückweg.

Starten Sie das Ziel über einen kontrollierten LAN-Zugang und vermeiden Sie, beide Instanzen gleichzeitig mit denselben Funkgeräten, Webhooks, Cloud-Konten oder Automatisierungen auszuführen, sofern Sie sie nicht bewusst voneinander getrennt haben. Zwei aktive Home-Assistant-Instanzen können doppelte Aktionen auslösen oder um denselben Koordinator konkurrieren, sodass eine korrekte Datenmigration fehlerhaft wirkt.

Benutzer, Verlauf, Einstellungen und Gerätesteuerung vor der Umstellung überprüfen

Melden Sie sich mit einem bestehenden Konto ohne Administratorrechte an, bestätigen Sie, dass ein Administratorkonto vorhanden ist, öffnen Sie Verlaufsdiagramme aus der Zeit vor dem Umzug, überprüfen Sie Integrationen, lösen Sie repräsentative Automatisierungen aus und prüfen Sie ein Gerät für jedes wichtige Protokoll. Starten Sie Home Assistant anschließend neu und starten Sie den Zielhost neu, um sicherzustellen, dass der wiederhergestellte Zustand normale Neustarts und Betriebsabläufe übersteht.

Die dazugehörige Erklärung von ZimaSpace zu dauerhaften Home-Assistant-Daten liefert eine nützliche Grenze für die Wiederherstellung: Dauerhafte Identitätsdaten, Konfigurationen und Verlaufsdaten sollten bei einem Umzug anders behandelt werden als Cache- oder temporäre Dateien.

Ändern Sie DNS, Proxy oder Fernzugriff erst, wenn die lokalen Tests bestanden sind. Lassen Sie den alten Host ausgeschaltet, aber wiederherstellbar, und zwar mindestens einen normalen Nutzungszyklus lang. Nehmen Sie ihn erst außer Betrieb, wenn Benutzer, Verlauf, Einstellungen, Automatisierungen, Funkgeräte, externe Dienste, die Erstellung von Backups und ein Neustart erwartungsgemäß funktionieren. Ein erfolgreicher erster Aufruf des Dashboards reicht nicht aus, um den Rückweg zu 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.