Eine Checkliste für die sichere Migration von Home Assistant auf einen neuen Heimserver

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.

Eine sichere Migration von Home Assistant ist nicht abgeschlossen, sobald der neue Server den Anmeldebildschirm erreicht. Der neue Host muss dieselbe Konfiguration, Funkgeräte, Integrationen, Speicherpfade, Netzwerkidentität und dasselbe Verhalten bei der lokalen Steuerung wiederherstellen, bevor der alte Server außer Betrieb genommen wird.

Behandeln Sie den Umzug als Wiederherstellungstest, während weiterhin eine Rückfallkopie verfügbar ist. Erstellen Sie ein frisches Backup, dokumentieren Sie die Abhängigkeiten des alten Servers, stellen Sie das Backup auf dem Ziel wieder her, verbinden Sie Funkgeräte und Netzwerkspeicher erneut, testen Sie wichtige Automatisierungen und lassen Sie die Quelle anschließend ausgeschaltet, aber intakt, bis die neue Installation die normale Nutzung und einen Neustart übersteht.

Erstellen Sie ein frisches vollständiges Backup und bewahren Sie den Wiederherstellungsschlüssel außerhalb des alten Hosts auf

Der aktuelle Backup-Workflow von Home Assistant unterstützt die Migration während der Einrichtung, einschließlich der Migration zwischen unterschiedlichen Gerätetypen. Stellen Sie vor dem Beginn sicher, dass das Ziel über ausreichend Speicher verfügt, laden Sie das Backup herunter oder bewahren Sie es anderweitig auf und halten Sie das für die Entschlüsselung benötigte Notfallpaket außerhalb der zu ersetzenden Maschine bereit.

Das aktuelle Migrationsverfahren von Home Assistant verwendet während der Einrichtung auf dem neuen Gerät ein Backup vom alten Gerät und weist ausdrücklich darauf hin, dass Netzwerkspeicher und die Migration von Funkgeräten möglicherweise weitere Nacharbeiten erfordern.

Überschreiben Sie während des Umzugs nicht das einzige Backup. Bewahren Sie mindestens eine Kopie unabhängig von beiden Servern auf, damit ein ausgefallenes Ziellaufwerk oder ein versehentliches Zurücksetzen nicht gleichzeitig die Wiederherstellungsquelle und die Quellinstallation entfernt.

Dokumentieren Sie die Abhängigkeiten, die durch ein Backup nicht physisch umgezogen werden

Ein Backup kann den Zustand von Home Assistant bewahren, aber es kann keinen USB-Zigbee- oder Z-Wave-Stick, kein Netzwerkkabel, keine USV-Verbindung, keinen externen Datenbank-Host, keinen MQTT-Broker, keinen Reverse-Proxy, keine NAS-Freigabe und keine Router-Reservierung physisch umziehen. Notieren Sie diese Abhängigkeiten, bevor Sie den alten Host ausschalten.

Dokumentieren Sie die alte IP-Adresse oder den Hostnamen von Home Assistant, die externe URL, Netzwerkspeicher-Einhängungen, die Datenbank-URL, falls Recorder extern betrieben wird, die Broker-Adresse, USB-Geräte, Funktypen sowie alle hostseitigen Compose- oder VM-Einstellungen. Anhand dieser Bestandsaufnahme können Sie eine fehlgeschlagene Wiederherstellung von einer fehlenden externen Abhängigkeit unterscheiden.

Die umfassendere Migrations-Checkliste von ZimaSpace folgt derselben Regel: Schützen Sie die Quelle, legen Sie fest, was tatsächlich zum Umfang gehört, überprüfen Sie das Ziel und behalten Sie die alte Kopie, bis die normale Nutzung nachweislich funktioniert.

Verschieben Sie Zigbee- und Z-Wave-Netzwerke als eigenen Migrationsschritt

Wenn dasselbe USB-Funkgerät auf den neuen Host umzieht, schließen Sie es erneut an und überprüfen Sie den Gerätepfad. Wenn der neue Server ein anderes integriertes oder ersetzendes Funkgerät verwendet, migrieren Sie das Funknetzwerk, statt davon auszugehen, dass das Home-Assistant-Backup allein die Coordinator-Identität ändert.

ZHA erstellt automatisch Netzwerk-Backups und unterstützt die Migration eines Zigbee-Netzwerks zu einem anderen unterstützten Coordinator, ohne das gesamte Mesh-Netzwerk neu zu koppeln. Der Migrationsprozess kann bei Bedarf auch die IEEE-Identität des Funkgeräts übertragen.

Z-Wave verfügt über einen separaten Controller-Zustand. Eine aktuelle Migrationsdiskussion zu Z-Wave JS UI bestätigt, dass der Service-Speicher und ein NVM-Backup die entscheidenden Wiederherstellungsressourcen beim Umzug des Z-Wave-Dienstes auf neue Hardware sind. Behandeln Sie beide Funknetzwerke als Ressourcen mit eigenen Wiederherstellungsverfahren.

-15% OFF

Stellen Sie zunächst wieder her und verbinden Sie anschließend externen Speicher und Netzwerkdienste

Starten Sie die Home-Assistant-Instanz auf dem Ziel zunächst aus dem Backup, bevor Sie Router, DNS, NAS-Berechtigungen oder mehrere Dienstadressen gleichzeitig ändern. Eine Migration lässt sich leichter diagnostizieren, wenn sich der neue Host vom alten zunächst nur in einer wesentlichen Variable unterscheidet.

Wenn die alte Installation Netzwerkspeicher verwendet hat, verbinden Sie ihn nach der Wiederherstellung erneut und überprüfen Sie die erwarteten Freigabenamen und Zugangsdaten. Wenn sie eine externe Datenbank oder einen MQTT-Broker verwendet hat, testen Sie DNS und die TCP-Konnektivität vom neuen Host, bevor Sie eine Home-Assistant-Konfiguration ändern, die nachweislich bereits funktioniert hat.

Der Anwendungszustand kann umziehen, host-spezifische Abhängigkeiten müssen jedoch weiterhin korrekt neu eingerichtet werden. Halten Sie das Migrationsprotokoll auf die Dinge konzentriert, die ein Home-Assistant-Backup nicht physisch verlagern kann: Funkgeräte, Host-Netzwerk, externer Speicher, Datenbankdienste, Broker-Endpunkte und alle Bereitstellungseinstellungen, die dem alten Server gehören.

Führen Sie vor der Stilllegung des alten Servers einen Abnahmetest durch

  • Bestätigen Sie, dass die erwarteten Benutzer, Dashboards, Integrationen, Helfer, Automatisierungen und Bereiche vorhanden sind.
  • Lösen Sie eine wichtige lokale Automatisierung aus und bestätigen Sie die Rückmeldung des physischen Geräts.
  • Überprüfen Sie, ob Zigbee-, Z-Wave-, Bluetooth- oder andere Funkgeräte verfügbar sind.
  • Bestätigen Sie, dass Recorder-Verlauf und Statistiken normal geschrieben werden.
  • Testen Sie einen Pfad zum Netzwerkspeicher und eine externe Abhängigkeit wie MQTT, falls verwendet.
  • Testen Sie den lokalen und den Remote-Zugriff getrennt voneinander.
  • Starten Sie den neuen Home-Assistant-Host einmal neu und wiederholen Sie den kritischen Test der lokalen Steuerung.

Erst wenn dieser Test nach dem zweiten Start erfolgreich ist, sollten Sie in Betracht ziehen, den alten Server zu löschen oder einer neuen Verwendung zuzuführen. Bis dahin sollte die Quellinstallation ausgeschaltet, von konkurrierenden Funkgeräten oder IP-Adressen getrennt und als Rückfallreferenz verfügbar bleiben.

Support & 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.