Zum Inhalt springen
SONOYA.com
Raspberry Pi & Linux

Home Assistant Backup: Schlüssel, USB-Laufwerk und NAS

Home Assistant richtig sichern: Notfallschlüssel, USB-Laufwerk, NAS und Google Drive, plus fertige Automationen, die fehlende Backups melden.

Von

Archivbox-Symbol auf rotem Verlauf für die Datensicherung von Home Assistant auf USB-Laufwerk und NAS

Ein Smart Home wächst über Jahre: Automationen, Dashboards, gekoppelte Zigbee-Geräte, die Energiestatistik. Stirbt die SD-Karte im Raspberry Pi oder geht ein Update schief, ist all das ohne Backup weg. Home Assistant bringt ein gutes Backup-System mit, das aber zwei Stolperfallen hat: Die Sicherungen liegen ab Werk auf demselben Gerät, das ausfallen kann, und sie sind verschlüsselt. Ohne den Schlüssel lässt sich ein Backup nicht wiederherstellen, auch nicht mit Hilfe von Nabu Casa.

Diese Anleitung richtet die Sicherung so ein, dass sie im Ernstfall wirklich hilft. Stand ist Home Assistant 2026.11 mit Home Assistant OS, die Schritte folgen der offiziellen Backup-Dokumentation.

Ein Hinweis zu den Menünamen: Die Schaltflächen nenne ich so, wie sie in der Oberfläche heißen. In der deutschen Übersetzung können einzelne Begriffe leicht abweichen.

Schritt 1: Automatische Backups einschalten

Öffne Einstellungen > System > Backups. Hast Du noch nie Backups eingerichtet, steht dort die Karte Set up backups. Tippe darauf.

Als Erstes zeigt Home Assistant den Verschlüsselungsschlüssel. Lade ihn an dieser Stelle gleich herunter (mehr dazu im nächsten Schritt) und tippe dann auf Weiter. Danach hast Du die Wahl zwischen Recommended und Custom.

Die empfohlene Einstellung sichert täglich alles außer den Ordnern für Medien und geteilte Dateien und behält die letzten drei Backups. Für die meisten Installationen passt das. Wählst Du Custom, kannst Du Zeitplan, Anzahl und Inhalt selbst festlegen. Lass dabei Home Assistant settings und History an, denn darin stecken Deine Konfiguration und die Verlaufsdaten. Medien und den Share-Ordner kannst Du weglassen, sie machen das Backup nur groß.

Schritt 2: Den Notfallschlüssel sicher aufbewahren

Seit 2025 verschlüsselt Home Assistant Backups standardmäßig. Das schützt Passwörter und Zugangsdaten, falls jemand eine Sicherung in die Hände bekommt. Die Kehrseite: Ohne Schlüssel kein Restore.

  1. Öffne Einstellungen > System > Backups.
  2. Tippe auf der Karte Encryption key neben Download emergency kit auf Download.

Du bekommst eine Textdatei mit dem Schlüssel, dem Namen Deiner Installation und dem Datum. Lege sie nicht nur auf dem Home-Assistant-Gerät ab, sondern zum Beispiel in Deinem Passwortmanager und zusätzlich ausgedruckt bei Deinen Unterlagen. Wenn Du den Schlüssel später änderst, brauchst Du für ältere Backups weiterhin den alten. Heb deshalb beide auf.

Schritt 3: Backups auf ein zweites Laufwerk legen

Ein Backup, das nur auf der SD-Karte liegt, hilft nicht, wenn genau diese Karte stirbt. Deshalb kommt mindestens ein zweiter Speicherort dazu. Am einfachsten sind ein USB-Laufwerk am Home-Assistant-Gerät oder eine Freigabe auf einem NAS.

Variante USB-Laufwerk

Seit Home Assistant 2026.11 kann Home Assistant OS Laufwerke, die direkt am Gerät stecken, für Backups nutzen. Ein kleiner USB-Stick (Affiliate Link) oder eine kompakte SSD (Affiliate Link) genügt.

  1. Formatiere das Laufwerk vorher am Mac oder PC, etwa mit exFAT. Home Assistant formatiert Laufwerke nicht selbst.
  2. Steck es an und öffne Einstellungen > System > Storage.
  3. Tippe auf Add storage, wähle als Typ Local disk, gib einen Namen ohne Leerzeichen ein, etwa usb_backup, und wähle bei der Verwendung Backup.
  4. Wähle das Laufwerk aus und tippe auf Connect.

Das erste Laufwerk, das Du mit der Verwendung Backup hinzufügst, wird automatisch zum Standardziel für lokale Backups.

Variante NAS

Hast Du ein NAS oder eine Freigabe auf einem anderen Rechner, ist das der bessere Ort, weil die Sicherung dann auch einen Defekt des ganzen Geräts übersteht. Wie Du auf einem Raspberry Pi selbst eine solche Freigabe baust, zeigt Samba auf dem Raspberry Pi: Netzwerkfreigabe für Mac und PC.

  1. Lege auf dem NAS einen Ordner wie homeassistant und einen eigenen Benutzer mit Schreibrecht dafür an.
  2. Öffne in Home Assistant Einstellungen > System > Storage und tippe auf Add storage.
  3. Wähle Samba/Windows (CIFS), gib einen Namen wie nas_backup ein und wähle bei der Verwendung Backup.
  4. Trag die IP-Adresse des NAS bei Server, den Freigabenamen bei Remote share sowie Benutzername und Passwort ein.
  5. Tippe auf Connect.

Danach öffnest Du unter Einstellungen > System > Backups auf der Karte zur automatischen Sicherung Configure backup settings und wählst das NAS als zusätzlichen Speicherort aus. Home Assistant legt jedes automatische Backup dann auf beiden Zielen ab.

Optional: eine Kopie außer Haus

Brand, Wasserschaden oder Einbruch erwischen Gerät und NAS gleichzeitig. Profis sprechen von der 3-2-1-Regel: drei Kopien, auf zwei verschiedenen Speichern, eine davon außer Haus. Für die Kopie außer Haus gibt es zwei bequeme Wege.

Home Assistant Cloud ist der einfachste. Mit dem Abo von Nabu Casa speichert Home Assistant automatisch das jeweils letzte Backup verschlüsselt in der Cloud, bis zu 5 GB groß. Mehr als ein Backup hält die Cloud allerdings nicht vor.

Google Drive ist kostenlos, braucht aber einmalig etwas Einrichtung, weil Du laut Anleitung von Home Assistant eigene Zugangsdaten bei Google anlegen musst:

  1. Leg in der Google Cloud Console ein Projekt an und aktiviere dort die Google Drive API.
  2. Richte den Zustimmungsbildschirm als „Extern“ ein und veröffentliche die App über Publish app. Ohne diesen Schritt laufen die Zugangsdaten laut Dokumentation alle sieben Tage ab, und die Backups bleiben unbemerkt aus.
  3. Erstelle einen OAuth-Client vom Typ „Web application“ mit der Weiterleitungsadresse https://my.home-assistant.io/redirect/oauth und notiere Client-ID und Client-Secret.
  4. Füge in Home Assistant die Integration Google Drive hinzu, gib die beiden Werte ein und bestätige die Anmeldung bei Google.

Home Assistant legt in Deinem Drive einen Ordner „Home Assistant“ an und hat nur auf diesen Ordner Zugriff. Danach wählst Du Google Drive in den Backup-Einstellungen als weiteren Speicherort. Wie viele Backups dort liegen bleiben, stellst Du über das Zahnrad neben dem Speicherort ein. Microsoft OneDrive funktioniert nach demselben Prinzip mit eigener Integration. Da alle Backups verschlüsselt sind, liegen in der Cloud keine lesbaren Daten.

Was ein Backup enthält und wie Du es klein hältst

Ein vollständiges Backup enthält Deine Konfiguration, alle Automationen und Dashboards, die Geräte- und Integrationsdaten, auf Wunsch die Verlaufsdatenbank und die Apps mit ihren Einstellungen. Auch das Zigbee-Netz von ZHA steckt darin, bei Zigbee2MQTT liegt es im Datenordner der App und ist nur dabei, wenn Du Apps mitsicherst.

Der größte Brocken ist fast immer die Verlaufsdatenbank. Sie speichert jeden Zustand jedes Sensors, standardmäßig für zehn Tage. Wie groß sie gerade ist, siehst Du unter Einstellungen > System > Reparaturen, dort im Menü oben rechts unter Systeminformationen beim Abschnitt Recorder. Mit diesen Zeilen in der configuration.yaml hältst Du sie schlank:

Code
recorder:
  purge_keep_days: 7
  exclude:
    domains:
      - update
    entity_globs:
      - sensor.*_signal_strength
    entities:
      - sensor.last_boot

purge_keep_days legt fest, wie viele Tage Verlauf aufbewahrt werden. Unter exclude schließt Du Sensoren aus, deren Verlauf Dich nicht interessiert, hier als Beispiel Update-Einträge, Signalstärken und den Zeitpunkt des letzten Starts. Die Namen ersetzt Du durch Deine eigenen Entitäten. Starte Home Assistant danach neu. Der Abschnitt ist in der Recorder-Dokumentation vollständig beschrieben.

Woran Du erkennst, dass die Sicherung funktioniert

Unter Einstellungen > System > Backups zeigt die Karte zur automatischen Sicherung das Datum des letzten erfolgreichen Backups. Tippe auf Show all backups: Bei jedem Eintrag siehst Du, auf welchen Speicherorten es liegt. Liegt es nur auf dem Home-Assistant-Gerät selbst, ist das NAS oder USB-Laufwerk noch nicht als Ziel ausgewählt.

Besser als regelmäßig nachzusehen ist eine Automation, die sich meldet, wenn etwas schiefgeht. Die Backup-Integration stellt dafür die Entität event.backup_automatic_backup bereit, die bei jedem Backup den Zustand meldet. Diese Automation schickt Dir eine Nachricht, sobald ein Backup fehlschlägt, samt Grund:

Code
alias: "Backup fehlgeschlagen melden"
triggers:
  - trigger: event.received
    target:
      entity_id: event.backup_automatic_backup
    options:
      event_type:
        - failed
actions:
  - action: notify.send_message
    target:
      entity_id: notify.mein_iphone
    data:
      title: "Backup fehlgeschlagen"
      message: >-
        Das letzte Backup ist fehlgeschlagen:
        {{ state_attr('event.backup_automatic_backup', 'failed_reason') }}

Ersetze notify.mein_iphone durch die Benachrichtigungs-Entität Deines Handys. Du findest sie unter Einstellungen > Geräte & Dienste > Entitäten, wenn Du nach „notify“ suchst. Am einfachsten legst Du die Automation unter Einstellungen > Automationen & Szenen an, wählst oben rechts In YAML bearbeiten und fügst den Text ein.

Ein Fehler wird damit gemeldet. Bleibt ein Backup aber ganz aus, etwa weil Home Assistant zur geplanten Zeit nicht lief, merkt diese Automation das nicht. Dafür gibt es den Sensor Last successful automatic backup, der Datum und Uhrzeit des letzten erfolgreichen Backups enthält. Such seine genaue Entitäts-ID ebenfalls in der Entitätenliste und setz sie in diese zweite Automation ein, die jeden Morgen prüft, ob das letzte Backup älter als zwei Tage ist:

Code
alias: "Backup zu alt melden"
triggers:
  - trigger: time
    at: "09:00:00"
conditions:
  - condition: template
    value_template: >-
      {{ now() - as_datetime(states('sensor.backup_last_successful_automatic_backup')) > timedelta(days=2) }}
actions:
  - action: notify.send_message
    target:
      entity_id: notify.mein_iphone
    data:
      title: "Backup veraltet"
      message: "Seit mehr als zwei Tagen gab es kein erfolgreiches Backup."

Die ID sensor.backup_last_successful_automatic_backup ist ein Beispiel, sie kann bei Dir anders lauten.

Die Notfallprobe: einmal im Jahr wiederherstellen

Ein Backup, das nie zurückgespielt wurde, ist eine Hoffnung, keine Sicherung. Einmal im Jahr lohnt eine Probe: Spiel das aktuelle Backup auf einem Ersatzgerät ein, etwa einem alten Raspberry Pi oder in einer virtuellen Maschine auf dem Mac, und prüf, ob Dashboards, Automationen und Verlauf da sind. Trenn das Ersatzgerät dabei vom Netzwerk oder schalte es direkt danach wieder aus, damit nicht zwei Home-Assistant-Installationen gleichzeitig Deine Geräte steuern. Dabei merkst Du auch, ob der Notfallschlüssel wirklich dort liegt, wo Du ihn vermutest.

Im Ernstfall wiederherstellen

Läuft Home Assistant noch, öffnest Du Einstellungen > System > Backups > Show all backups, wählst das Backup, legst fest, was zurückkommen soll, und tippst auf Restore.

Ist das Gerät tot, installierst Du Home Assistant OS neu, wie in Home Assistant auf dem Raspberry Pi installieren beschrieben. Schon der Begrüßungsbildschirm bietet Upload backup an. Lade dort die .tar-Datei von Deinem NAS oder USB-Laufwerk hoch, gib den Schlüssel aus dem Notfall-Kit ein und starte mit Restore backup. Bei einer größeren Installation dauert das laut Dokumentation bis zu etwa 45 Minuten. Schalte das Gerät in dieser Zeit nicht aus.

Typische Probleme

  • „Backup storage cannot be read-only“: Das Laufwerk wurde als nur lesbar eingebunden. Entferne es unter Storage und füge es ohne die Option Read-only neu hinzu.
  • NAS lässt sich nicht verbinden: Prüf Benutzername, Passwort und Freigabenamen. Erst wenn die Verbindung scheitert, zeigt Home Assistant das Feld für die Samba-Version. Lass dort Auto (2.1+) stehen, solange Dein NAS nicht ausdrücklich eine alte Version braucht.
  • Restore fragt nach einem Schlüssel, den Du nicht hast: Das Backup wurde mit einem früheren Schlüssel verschlüsselt. Ohne diesen alten Schlüssel ist es nicht wiederherstellbar. Deshalb jeden Schlüssel aufheben.
  • SD-Karte voll: Reduziere unter den Backup-Einstellungen die Anzahl der aufbewahrten Backups oder lass lokale Kopien weg, sobald USB-Laufwerk oder NAS als Ziel laufen. Wie Du die SD-Karte im Dauerbetrieb schonst, beschreibt Raspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen.

Fazit

Ein gutes Home-Assistant-Backup braucht drei Dinge: automatische tägliche Sicherungen, einen zweiten Speicherort wie USB-Laufwerk oder NAS und den Notfallschlüssel außerhalb von Home Assistant. Richte das einmal ein, kontrolliere ab und zu das Datum des letzten Backups, und ein Defekt kostet Dich nur noch eine Stunde statt eines kompletten Neuaufbaus.

Weiterlesen.