Backup & Restore

Warum Backups unverzichtbar sind

Dein Home Assistant System ist das Ergebnis von Stunden, Wochen oder Monaten an Konfiguration. Automationen, Dashboards, Integrationen, History-Daten — alles kann verloren gehen durch:

• SD-Karten-Tod — SD-Karten im Raspberry Pi haben eine begrenzte Lebensdauer (6-24 Monate bei intensiver Nutzung)
• Stromausfall — Unerwarteter Stromausfall kann die Datenbank oder Konfiguration beschädigen
• Fehlerhaftes Update — Ein HA-Update kann Breaking Changes enthalten, die dein System lahmlegen
• Konfigurationsfehler — Ein Tippfehler in YAML kann HA am Starten hindern
• Hardware-Defekt — SSD, Netzteil oder Mainboard können jederzeit ausfallen
• Sicherheitsvorfall — Im schlimmsten Fall muss das System komplett neu aufgesetzt werden

Hinweis: Ein Backup, das auf dem gleichen Gerät wie dein HA liegt, ist kein Backup! Wenn die SD-Karte stirbt, ist alles weg — inklusive Backup. Speichere Backups IMMER extern: NAS, Google Drive, USB-Stick, PC.

Backup-Typen verstehen

Was ist im Backup enthalten?

• Konfiguration — configuration.yaml, automations.yaml, scripts.yaml, scenes.yaml, secrets.yaml
• Integrationen — Alle eingerichteten Integrationen und deren Konfiguration
• Add-ons — Installierte Add-ons und deren Einstellungen/Daten
• Datenbank — home-assistant_v2.db mit History und Statistik-Daten
• Dashboard — Alle Lovelace-Dashboards und Custom Cards
• Benutzer — Alle Benutzerkonten und Berechtigungen

Manuelles Backup erstellen

1. Einstellungen öffnen — Einstellungen, System, Sicherungen
2. Sicherung erstellen — Klicke auf Sicherung erstellen und wähle den Backup-Typ
3. Optionen wählen — Vollständig oder Teilweise, optional mit Passwort
4. Warten — Je nach Systemgröße dauert das 1-10 Minuten
5. Herunterladen — Das fertige Backup auf die drei Punkte klicken und herunterladen
6. Extern speichern — Die .tar-Datei auf NAS, PC, USB oder Cloud übertragen

Hinweis: Erstelle immer ein vollständiges Backup bevor du Home Assistant, Add-ons oder das Betriebssystem aktualisierst. Im schlimmsten Fall kannst du so auf die funktionierende Version zurückkehren.

Automatische Backups einrichten

Methode 1: HA-eigene Backup-Automation

1# Automation: Tägliches Backup um 3 Uhr nachts
2automation:
3  - alias: "Tägliches Backup"
4description: "Erstellt jede Nacht um 3 Uhr ein vollständiges Backup"
5trigger:
6  - platform: time
7    at: "03:00:00"
8condition:
9  - condition: time
10    weekday:
11      - mon
12      - wed
13      - fri
14      - sun
15action:
16  - service: backup.create
17    data:
18      name: "auto_{{ now().strftime('%Y-%m-%d_%H%M') }}"
19  
20  # Optional: Benachrichtigung senden
21  - delay: "00:10:00"   # Warten bis Backup fertig
22  - service: notify.mobile_app_mein_handy
23    data:
24      title: "Backup erstellt"
25      message: "Automatisches Backup wurde erfolgreich erstellt."
26      data:
27        tag: "backup_notification"

Methode 2: Google Drive Backup (empfohlen)

Das Add-on Home Assistant Google Drive Backup ist die beliebteste Lösung für automatische, externe Backups. Es erstellt Backups und lädt sie automatisch auf Google Drive hoch.

1. Add-on installieren — Add-on Store, nach Google Drive Backup suchen (Community Add-on Repository nötig)
2. Google-Konto verknüpfen — Add-on öffnen, dem Authentifizierungs-Link folgen und Google-Konto verknüpfen
3. Zeitplan konfigurieren — Backup-Frequenz, Aufbewahrung und Benennung festlegen
4. Fertig — Ab jetzt werden Backups automatisch erstellt und auf Google Drive hochgeladen

1# Google Drive Backup - Empfohlene Einstellungen
2# Add-on Konfiguration (Web-UI):
3# 
4# Backup-Frequenz:     Täglich
5# Backup-Zeit:         03:00 Uhr
6# Backup-Typ:          Vollständig
7# Passwort:            (starkes Passwort setzen!)
8#
9# Aufbewahrung:
10#   In Home Assistant:  3 Backups behalten
11#   In Google Drive:    10 Backups behalten
12#
13# Generalized Upload:  Aktiviert
14# Benachrichtigungen:  Bei Fehler benachrichtigen
15#
16# Erweitert:
17#   Backup-Name:       {type}_{date}_{time}
18#   Ordner in Drive:    Home Assistant Backups

Methode 3: Samba/NAS Backup

1# Shell Command für NAS-Backup
2# In configuration.yaml:
3shell_command:
4  backup_to_nas: >
5cp /backup/*.tar /media/nas_backup/ 2>/dev/null; 
6echo "Backup auf NAS kopiert"
7  
8  cleanup_old_backups: >
9find /backup -name "*.tar" -mtime +7 -delete;
10echo "Alte lokale Backups gelöscht"
11
12# Automation:
13automation:
14  - alias: "Backup auf NAS kopieren"
15trigger:
16  - platform: time
17    at: "04:00:00"
18action:
19  - service: backup.create
20    data:
21      name: "nas_{{ now().strftime('%Y-%m-%d') }}"
22  - delay: "00:15:00"
23  - service: shell_command.backup_to_nas
24  - delay: "00:02:00"  
25  - service: shell_command.cleanup_old_backups

Backup wiederherstellen (Restore)

Szenario 1: System läuft noch

1. Sicherungen öffnen — Einstellungen, System, Sicherungen
2. Backup wählen — Das gewünschte Backup aus der Liste wählen
3. Wiederherstellen — Auf Wiederherstellen klicken, Vollständig oder Teilweise wählen
4. Neustart abwarten — HA startet neu und stellt alle Daten wieder her

Szenario 2: Kompletter Neustart (neues Gerät/neue SD-Karte)

1. HA OS neu installieren — Frisches HA OS Image auf neue SD-Karte/SSD flashen
2. System starten — Starten und warten bis die Onboarding-Seite erscheint
3. Backup hochladen — Auf der Onboarding-Seite: Aus Sicherung wiederherstellen wählen
4. Backup-Datei wählen — Die .tar-Datei vom PC hochladen oder vom Netzwerk wählen
5. Restore starten — Wiederherstellen klicken und warten (kann 10-30 Min. dauern)
6. Fertig — Alles ist wiederhergestellt: Config, Add-ons, Dashboards, User

Hinweis: Nach der Wiederherstellung musst du evtl. Zigbee/Z-Wave-Sticks neu zuweisen, wenn du auf neue Hardware gewechselt hast (anderer USB-Port). Auch IP-Adressen von Geräten könnten sich geändert haben.

Szenario 3: Notfall-Restore über SSH

1# Restore über SSH (wenn Web-UI nicht erreichbar)
2# Per SSH verbinden:
3ssh root@homeassistant.local -p 22222
4
5# Verfügbare Backups auflisten:
6ha backups list
7
8# Backup wiederherstellen (mit Slug-Name):
9ha backups restore abc12345 --homeassistant --addons
10
11# Oder: Backup von URL laden
12ha backups reload
13
14# System-Log prüfen:
15ha core logs
16
17# Falls HA nicht startet:
18ha core rebuild

Backup-Strategien vergleichen

• NAS/Samba — Kontrolle: 85%/>

Vorteile:

• Google Drive: Automatisch, offsite, kostenlos bis 15 GB
• NAS: Schnell, lokal, grosse Kapazität
• Manuell: Kein Setup nötig, volle Kontrolle
• Verschlüsselt: Sicher auch auf fremdem Speicher

Nachteile:

• Google Drive: Abhängigkeit von Google, Internetverbindung nötig
• NAS: Zusätzliche Hardware nötig, kein Offsite
• Manuell: Wird leicht vergessen, kein Zeitplan
• USB-Stick: Kann verloren gehen, begrenzte Haltbarkeit

SD-Karten-Problem und SSD-Migration

Der häufigste Grund für Datenverlust bei Home Assistant ist der Tod der SD-Karte. SD-Karten sind nicht für dauerhaftes Schreiben ausgelegt und versagen typischerweise nach 6-24 Monaten.

Auf SSD/USB migrieren

1. SSD besorgen — Eine kleine SSD (128-256 GB) mit USB-Adapter oder M.2-Gehäuse
2. Vollständiges Backup — Erstelle ein vollständiges Backup und lade es herunter
3. HA OS auf SSD flashen — Mit Balena Etcher oder Raspberry Pi Imager auf die SSD flashen
4. SSD anschließen — SD-Karte entfernen, SSD per USB anschließen, Pi starten
5. Backup wiederherstellen — Auf der Onboarding-Seite: Aus Sicherung wiederherstellen
6. SD-Karte als Backup behalten — Die alte SD-Karte aufbewahren als Notfall-Boot-Medium

Hinweis: Der Pi 3 braucht einmalig eine spezielle Konfiguration für USB-Boot. Der Pi 4 und Pi 5 können ab Werk von USB booten. Für den Pi 3: program_usb_boot_mode=1 in config.txt setzen.

Backup-Checkliste

• Automatisiert — Backups laufen automatisch mindestens alle 2 Tage
• Extern gespeichert — Backups liegen auf NAS, Google Drive oder anderem externen Speicher
• Verschlüsselt — Cloud-Backups sind mit einem starken Passwort geschützt
• Getestet — Du hast mindestens einmal einen Restore getestet
• Rotation — Alte Backups werden automatisch gelöscht (z.B. älter als 14 Tage)
• Vor Updates — Vor jedem HA-Update wird manuell ein Backup erstellt

Hinweis: Ein Backup, das du nie getestet hast, ist wie eine Versicherung, die nicht zahlt. Stelle mindestens einmal sicher, dass du erfolgreich aus einem Backup wiederherstellen kannst — am besten auf einer separaten SD-Karte oder einem Test-System.

Weiter: Erfahre mehr über Troubleshooting und Performance: Troubleshooting Guide