Ein Home Assistant Backup kann dein Smart Home nach einem fehlgeschlagenen Update, einem defekten Datenträger oder einem Hardwarewechsel retten. Ob die Sicherung dafür taugt, erkennst du nicht allein daran, dass eine Datei vorhanden ist. Entscheidend ist, ob du sie auf einem frisch installierten System einspielen kannst und danach deine wichtigsten Geräte und Automationen funktionieren.
Dieser Leitfaden zeigt dir einen Praxistest zum Nachmachen: Du erstellst eine Sicherung, stellst sie auf einer zweiten Home-Assistant-Installation wieder her und prüfst das Ergebnis. Anschließend findest du Lösungen für typische Fehler bei der Wiederherstellung.
Falls du Home Assistant gerade erst eingerichtet hast, lies vorher unseren Artikel Home Assistant: Die ersten Schritte nach der Installation. Dort geht es unter anderem um die Grundkonfiguration, Netzwerk und Sicherheit.
Was sich mit einem Home-Assistant-Backup sichern lässt
Home Assistant erstellt Backups als komprimierte .tar-Dateien. Eine vollständige Sicherung umfasst die Konfiguration sowie die vorgesehenen Verzeichnisse für Freigaben, Medien und Zertifikate. Bei Home Assistant OS können außerdem installierte Apps und deren Daten Bestandteil der Sicherung sein. Du kannst bei der Erstellung auch einzelne Bestandteile auswählen. Welche Teile tatsächlich enthalten sind, solltest du vor jedem wichtigen Backup kontrollieren.
Ein Home-Assistant-Backup ist keine Kopie deiner gesamten technischen Umgebung. Ein separat betriebener MQTT-Broker, eine externe Datenbank oder ein eigenständiger Zigbee2MQTT-Container brauchen ihre eigenen Sicherungen. Auch USB-Sticks, Funkmodule, Netzwerkeinstellungen des Routers und die Stromversorgung werden durch die Backup-Datei nicht ersetzt.
Die integrierte Backup-Funktion steht auch bei Home Assistant Container zur Verfügung. Andere Container und deren Daten musst du jedoch getrennt berücksichtigen. Home Assistant Container bringt zudem keine Home-Assistant-OS-Apps mit.
Vor dem Praxistest: Diese Dinge brauchst du
Plane für den Test eine zweite Installation ein, etwa eine virtuelle Maschine oder ein Ersatzgerät. So bleibt dein produktives Smart Home während des Probelaufs erreichbar.
- Eine aktuelle Backup-Datei oder Zugriff auf deinen eingerichteten Backup-Speicherort
- Das zum Backup gehörende Backup Emergency Kit mit dem Verschlüsselungsschlüssel
- Benutzername und Passwort deiner Home-Assistant-Installation zum Zeitpunkt der Sicherung
- Ausreichend freien Speicherplatz auf dem Zielgerät
- Zugriff auf die Geräte und Dienste, die du nachher prüfen möchtest
Bewahre Backup-Datei und Emergency Kit außerhalb des Home-Assistant-Geräts auf. Wenn dieses Gerät ausfällt, hilft dir eine ausschließlich dort gespeicherte Sicherung wenig. Für ältere verschlüsselte Backups benötigst du weiterhin den jeweils passenden Schlüssel, falls du ihn zwischenzeitlich geändert hast. Ohne diesen Schlüssel lässt sich ein verschlüsseltes Backup unter Umständen nicht wiederherstellen.
Wichtig für den Test: Lass nicht zwei Installationen gleichzeitig dieselben Geräte steuern. Trenne bei Bedarf Funksticks vom Produktivsystem oder teste die Wiederherstellung zunächst ohne aktive Verbindung zu den betroffenen Geräten.
Schritt 1: Ein neues Home-Assistant-Backup erstellen
Öffne in Home Assistant Einstellungen → System → Backups. Falls du automatische Sicherungen noch nicht eingerichtet hast, kannst du dort Zeitplan, Aufbewahrung und Speicherorte festlegen. Aktiviere nach Möglichkeit einen Speicherort außerhalb des Home-Assistant-Geräts.
Für unseren Praxistest erstellst du eine manuelle Sicherung:
- Wähle Jetzt sichern und anschließend Manuelles Backup.
- Prüfe, welche Daten enthalten sein sollen. Für einen vollständigen Wiederherstellungstest wählst du alle benötigten Bestandteile aus.
- Gib dem Backup einen eindeutigen Namen, beispielsweise
Vor-Wiederherstellungstest. - Wähle den Speicherort und starte die Sicherung.
- Warte, bis Home Assistant das Backup als abgeschlossen anzeigt.
- Lade eine Kopie auf deinen Computer herunter und sichere das zugehörige Emergency Kit getrennt davon.
Große Medienordner oder umfangreiche App-Daten verlängern Sicherung und Wiederherstellung. Wenn du sie ausschließt, dokumentiere das ausdrücklich: Dein Test kann dann nicht belegen, dass diese Daten nach einer Wiederherstellung vorhanden sind.
Schritt 2: Den Ausgangszustand festhalten
Bevor du das Backup einspielst, notiere dir einige Merkmale der bestehenden Installation. Das macht die spätere Kontrolle deutlich einfacher.
| Prüfpunkt | Was du festhalten solltest |
|---|---|
| Dashboard | Anzahl und Namen der wichtigsten Ansichten |
| Automationen | Zwei bis drei wichtige Abläufe samt Aktivierungsstatus |
| Integrationen | Beispielsweise MQTT, ZHA und Wetterdienst |
| Geräte | Eine Lampe, ein Sensor und ein batteriebetriebenes Gerät |
| Apps und externe Dienste | Welche laufen innerhalb von Home Assistant OS, welche separat? |
| Netzwerk | Bisherige Adresse und gegebenenfalls feste IP-Zuweisung |
Notiere keine Passwörter im Prüfprotokoll. Halte lediglich fest, wo du sie sicher verwahrst.
Schritt 3: Home Assistant auf dem Testgerät wiederherstellen
Installiere Home Assistant auf dem Zielgerät und öffne die Willkommensseite der neuen Installation. Beginne dort mit der Wiederherstellung, bevor du einen neuen Benutzer und eine neue Konfiguration anlegst.
- Wähle auf der Willkommensseite Backup hochladen. Liegt die Sicherung in Home Assistant Cloud, kannst du stattdessen den dort angebotenen Wiederherstellungsweg verwenden.
- Wähle die Backup-Datei auf deinem Computer aus.
- Kontrolliere im folgenden Dialog, welche Bestandteile wiederhergestellt werden. Für diesen vollständigen Test wählst du alle im Backup enthaltenen Teile.
- Gib bei einem verschlüsselten Backup den Schlüssel aus dem passenden Emergency Kit ein.
- Starte die Wiederherstellung und lass den Vorgang durchlaufen.
- Melde dich nach dem Neustart mit den Zugangsdaten der gesicherten Installation an.
Während der Wiederherstellung kann die Oberfläche vorübergehend nicht erreichbar sein. Lade die Seite in dieser Phase nicht ständig neu. Bei größeren Installationen kann der Vorgang ungefähr 45 Minuten dauern; die tatsächliche Zeit hängt von Datenmenge und Hardware ab. Nach Abschluss kann die Adresse vom bisherigen Gerät abweichen. Wenn deine alte Installation HTTPS direkt in Home Assistant eingerichtet hatte, rufe sie gegebenenfalls mit https:// statt http:// auf.
Speicherplatz nicht nach der Dateigröße schätzen: Das komprimierte Backup kann erheblich kleiner sein als die wiederhergestellten Daten. Prüfe auf der bisherigen Installation unter Einstellungen → System → Reparaturen → Systeminformationen den belegten Speicher und stelle auf dem Zielgerät genügend Platz bereit.
Schritt 4: Das Ergebnis prüfen
Eine erfolgreiche Anmeldung ist ein guter Anfang. Der eigentliche Praxistest endet erst, wenn die für dich wichtigen Funktionen geprüft sind.
Gehe die folgende Liste durch und notiere zu jedem Punkt erfolgreich, Fehler oder nicht getestet:
- Oberfläche: Sind Dashboards, Ansichten und Benutzer wie erwartet vorhanden?
- Konfiguration: Stimmen wichtige Einstellungen, Helfer, Skripte und Automationen?
- Integrationen: Werden die benötigten Integrationen geladen? Gibt es Hinweise unter Einstellungen → System → Reparaturen oder in den Protokollen?
- Geräte: Melden sich ausgewählte Sensoren, und lässt sich ein unkritischer Aktor schalten?
- Automationen: Lässt sich ein geeigneter Ablauf kontrolliert auslösen? Prüfe anschließend seine Ausführung.
- Apps und externe Dienste: Laufen die benötigten Dienste, und sind ihre Daten vorhanden?
- Backup-Ziel: Ist der externe Speicherort weiterhin verbunden? Erstelle zum Schluss eine neue Testsicherung.
Batteriebetriebene Geräte melden sich möglicherweise erst nach ihrem nächsten Aufwachen. Bei einem Hardwarewechsel können außerdem Funksticks und Netzwerkschnittstellen andere Pfade oder Kennungen haben. Prüfe solche Abweichungen gezielt, bevor du Geräte neu anlernst. Für den Wechsel eines Zigbee-Koordinators gelten zusätzliche Schritte.
Typische Fehler bei der Wiederherstellung
Das Backup ist nicht auffindbar
Prüfe zuerst, wo die Sicherung gespeichert wurde. Eine lokal auf dem ausgefallenen Gerät abgelegte Datei ist auf einer frischen Installation nicht automatisch verfügbar. Verwende die zuvor heruntergeladene Kopie oder greife auf deinen externen Speicherort zu. Wenn du Home Assistant Cloud nutzt, prüfe, ob dort tatsächlich ein Backup vorhanden ist. Der Cloud-Backup-Speicher hält die zuletzt dort gespeicherte Sicherung vor.
Der Verschlüsselungsschlüssel wird nicht akzeptiert
Kontrolliere, ob dein Emergency Kit wirklich zu diesem Backup gehört. Nach einem Wechsel des Verschlüsselungsschlüssels benötigen ältere Sicherungen weiterhin den alten Schlüssel. Ist die ursprüngliche Installation noch erreichbar, kannst du den aktuellen Schlüssel in den Backup-Einstellungen erneut abrufen. Bei einem alten Backup hilft das nur, wenn es mit genau diesem Schlüssel erstellt wurde.
Die Wiederherstellung scheint stehen zu bleiben
Gib dem Vorgang zunächst Zeit. Bei großen Backups müssen Daten übertragen, entpackt und Dienste neu eingerichtet werden. Prüfe anschließend, ob das Zielgerät ausreichend freien Speicherplatz hat und ob die Installation über ihre aktuelle IP-Adresse erreichbar ist. Ein vorübergehender Verbindungsabbruch während der Wiederherstellung ist zu erwarten.
Die Anmeldung mit dem neuen Passwort schlägt fehl
Nach der Wiederherstellung gelten die Zugangsdaten aus dem Zeitpunkt des Backups. Melde dich deshalb mit dem damals verwendeten Benutzernamen und Passwort an. Eine zwischen Sicherung und Wiederherstellung vorgenommene Passwortänderung ist in der älteren Sicherung nicht enthalten.
Geräte oder Integrationen sind nach dem Umzug nicht erreichbar
Prüfe zuerst die Grundlagen: Hat das neue Gerät die erwartete Netzwerkverbindung? Sind USB-Funksticks angeschlossen und an Home Assistant durchgereicht? Laufen externe Dienste wie MQTT-Broker oder Zigbee2MQTT? Eine wiederhergestellte Home-Assistant-Konfiguration kann einen separat betriebenen Dienst nicht selbst starten. Öffne danach die betroffene Integration und die Protokolle, um den konkreten Fehler einzugrenzen.
Der NAS-Speicherort fehlt
Netzwerkspeicher muss nach einer Wiederherstellung gegebenenfalls erneut verbunden werden. Prüfe Serveradresse, Freigabe, Zugangsdaten und die Erreichbarkeit des NAS. Unter Home Assistant OS findest du Netzwerkspeicher unter Einstellungen → System → Speicher. Für Backups muss der Speicherort mit der passenden Nutzungsart eingerichtet sein.
Bestehende Installation auf einen älteren Stand zurücksetzen
Läuft Home Assistant noch und möchtest du nur einen früheren Zustand einspielen, brauchst du keine Neuinstallation. Öffne Einstellungen → System → Backups, wähle die gewünschte Sicherung und anschließend die wiederherzustellenden Bestandteile. Danach startet Home Assistant neu.
Beachte: Die ausgewählten aktuellen Daten werden durch den Stand aus dem Backup ersetzt. Melde dich anschließend mit den Zugangsdaten an, die zum Zeitpunkt dieser Sicherung gültig waren.
Fazit: Eine Sicherung braucht einen Wiederherstellungstest
Für ein brauchbares Home-Assistant-Backup müssen drei Dinge zusammenkommen: Die Sicherung enthält alle benötigten Daten, eine Kopie liegt außerhalb des Home-Assistant-Geräts, und der passende Verschlüsselungsschlüssel ist verfügbar. Erst ein Probelauf auf einer zweiten Installation zeigt dir, ob du damit auch wieder arbeitsfähig wirst.
Wiederhole den Test nach größeren Änderungen an deiner Umgebung – etwa wenn du auf neue Hardware wechselst, zusätzliche externe Dienste einbindest oder deinen Backup-Speicherort änderst. Ein kurzes Prüfprotokoll spart im Ernstfall viel Zeit: Du weißt dann, welche Sicherung funktioniert hat und welche Schritte nach dem Einspielen noch nötig sind.