====== Backup und Wiederherstellung ======

[[ha:raderbroich:start|← Übersicht]]

===== Automatische Backups (seit 26.09.2026) =====

  * **Zeitplan:** **wöchentlich, sonntags 03:17 Uhr** (Entscheidung Norbert, 26.09.2026).
  * **Aufbewahrung:** **10 Kopien** = rund 10 Wochen. Gilt nur für die automatischen Backups; manuell erstellte Backups werden nie automatisch gelöscht.
  * **Inhalt:** Home Assistant, alle Add-ons, Datenbank, Ordner ''media'' und ''share''.
  * **Ziel:** **nur NAS** per NFS (''hassio.nas''). Lokal auf dem HA-Rechner wird nicht mehr gesichert.
  * **Test:** Am 26.09.2026 um 15:34 erfolgreich gesichert (81 MB).

===== Dauerhafte Backups =====

  * **„Dauerhaft 2026-09-26 (nicht löschen)“** – wird am 26.09.2026 um **23:00 Uhr** von der einmaligen Automation „Backup: Dauerhaftes NAS-Backup 26.09.2026 23:00 (einmalig)“ als Voll-Backup direkt aufs NAS geschrieben (verschlüsselt mit dem normalen Backup-Schlüssel). Weil es nicht mit den automatischen Einstellungen entsteht, löscht die Aufbewahrungsregel es nie. Die Automation schaltet sich danach selbst ab und kann gelöscht werden.
  * Weitere dauerhafte Backups: in HA unter //Einstellungen → System → Backups → „Jetzt sichern“ → „Manuelles Backup“//, Speicherort **nas** wählen.

==== NAS-Anbindung (NFS) ====

  * **Home Assistant:** //Einstellungen → System → Speicher → Netzwerkspeicher// – Eintrag ''nas'', Verwendung **Backup**, Server ''192.168.192.2'', Protokoll **NFS**, Remote-Freigabepfad ''/volume1/hassio''.
  * **Synology:** //Systemsteuerung → Dateidienste → NFS// aktiviert. //Freigegebener Ordner → hassio → NFS-Berechtigungen//: Host ''192.168.192.12'' (Home Assistant), Lesen/Schreiben. Kein Benutzer nötig, die Synology prüft nur die IP.
  * **Stolperfallen beim Einrichten:** Der Pfad braucht das Volume (''/volume1/hassio'', nicht ''/hassio''). Die macOS-Autokorrektur hat „hassio“ zu „Cassio“ geändert. Beides führte zu „access denied by server“ im Host-Log.
  * In der Freigabe liegen auch ältere Backups der **früheren HA-Installation** (z. B. „vorneuinstallation“ vom 21.09.2026, „Custom backup 2025.2.5“ und Add-on-Backups). HA zeigt sie in der Backup-Liste an, löscht sie aber nicht automatisch. Einige davon kann HA nicht lesen („Permission denied“ im Supervisor-Log) – das ist harmlos.
  * Die Synology-Integration hat ebenfalls ein Backup-Ziel (''nasnbruch'', Freigabe ''hassio''). Es wird **nicht** verwendet, weil dem DSM-Benutzer die Rechte fehlen; das NFS-Ziel ersetzt es.

===== Vorhandene Backups (Stand 26.09.2026) =====

^ Name ^ Datum ^ Größe ^ Datenbank ^ Ort ^
| Automatic backup 2026.9.3 | 26.09.2026 15:34 | 81 MB | ja | lokal + NAS |
| Automatic backup 2026.9.3 | 26.09.2026 14:40 | 80 MB | ja | lokal |
| mit richtigen Zonen und Personen | 24.09.2026 13:20 | 70 MB | ja | lokal |
| gute Grundversion incl Ute | 24.09.2026 12:11 | 70 MB | ja | lokal |
| Alarmanlage OK | 24.09.2026 11:08 | 70 MB | ja | lokal |
| Automatic backup 2026.9.3 | 24.09.2026 11:02 | 70 MB | ja | lokal |
| Komplett_Backup_2026-09-24 | 24.09.2026 10:49 | 25 MB | nein | lokal |

Die älteren lokalen Backups bleiben erhalten, bis sie von Hand gelöscht werden.

Alle Backups sind **passwortgeschützt**. Das **Backup-Passwort** (Verschlüsselungsschlüssel) liegt bei Norbert außerhalb von HA (gesichert am 26.09.2026) – ohne ihn ist keine Wiederherstellung möglich. Nicht ins Wiki schreiben.

===== Wiederherstellung (Kurzanleitung) =====

  - Home Assistant OS neu installieren und im Browser öffnen (''http://homeassistant.local:8123'').
  - Beim Einrichtungsassistenten **„Aus Backup wiederherstellen“** wählen und die Backup-Datei hochladen (vom NAS: Freigabe ''hassio'', Datei ''<backup_id>.tar'').
  - Backup-Passwort eingeben, vollständige Wiederherstellung.
  - Danach prüfen:
    * **Homematic IP Cloud** verbunden? Sonst neu koppeln (Taste am Access Point drücken).
    * **Reolink** erreichbar (IP 192.168.192.11)? Kamera-Steckdose über den Testmodus einschalten.
    * **Telegram-Bot**: Testnachricht mit ''script.telegram_universal_versand''.
    * **iPhones**: In der Companion-App prüfen, ob der Server verbunden ist; ggf. neu anmelden.
    * **HACS-Karten** (button-card, Camera Gallery Card) geladen? Sonst in HACS „neu herunterladen“.
    * **NAS-Speicher** ''nas'' unter //Einstellungen → System → Speicher// wieder anlegen (siehe oben).
  - Die Automation „Alarmstatus nach Neustart wiederherstellen“ synchronisiert den Alarmstatus automatisch.

===== Wenn die Homematic-Integration neu eingerichtet werden muss =====

Die neue Integration bekommt eine neue ''entry_id''. Anpassen:
  * Dashboard, Ansicht Main: ''custom:hmip-urlaub-card'' → ''entry_id''.
  * Entitätsnamen prüfen: Alle Automationen verwenden ''alarm_control_panel.hmip_raderbroich_hmip_alarm_control_panel'', ''switch.hmip_raderbroich_dose_tv'' usw. Bekommen die Entitäten neue Namen, müssen sie in Automationen, Skripten, Template-Sensoren und im Dashboard ersetzt werden.