💾 Backup & Recovery Strategy

Path: /home-assistant/setup/backup-strategy

::: info In un ambiente virtualizzato su Proxmox, la strategia di backup deve essere multi-livello. Non ci affidiamo solo ai backup interni di Home Assistant, ma sfruttiamo l’infrastruttura sottostante per garantire un ripristino istantaneo in caso di guasto hardware o errore software critico. :::

1. Livello 1: Snapshot di Proxmox (Short-term)

Gli snapshot sono “fotografie” istantanee dello stato della VM (inclusa la RAM).

Quando usarli: Prima di ogni aggiornamento di Home Assistant o modifica al configuration.yaml.
Vantaggio: Il ripristino richiede meno di 10 secondi.
Best Practice: Non conservare snapshot per più di 24-48 ore per evitare overhead sul file system.

2. Livello 2: Proxmox Backup (Scheduled)

Configurazione dei backup automatici verso lo storage esterno (NAS QNAP/Synology via NFS).

Pianificazione: Giornaliera (es. ore 04:00).
Retention Policy: keep-last=5 (mantenimento degli ultimi 5 backup).
Modalità: Snapshot (la VM/CT non viene spenta durante il backup).

🛠️ Troubleshooting: Risoluzione Errore Permessi LXC (NFS)

Se il backup delle VM funziona ma quello dei Container LXC fallisce con l’errore tar: ... Cannot open: Permission denied, è dovuto al mapping degli UID dei container unprivileged su share NFS.

La Causa (Root Cause)

I container LXC unprivileged usano un mapping di utenti (UID 100000). Quando Proxmox tenta di creare i file temporanei del backup direttamente sul NAS via NFS, il Synology rifiuta la scrittura perché non riconosce l’utente 100000.

La Soluzione: Modifica di `vzdump.conf`

Dobbiamo forzare Proxmox a usare una directory locale per i file temporanei prima di inviare l’archivio finale al NAS.

Accedi alla Shell di Proxmox.
Modifica il file di configurazione:
```
nano /etc/vzdump.conf
```
Decommenta e imposta il parametro tmpdir:
```
tmpdir: /var/tmp
```
Salva e riavvia il job di backup. Ora il processo tar userà il disco locale per i metadati, evitando il conflitto di permessi NFS.

📉 Workflow di Ripristino (Mermaid)

graph TD
    A[Rilevamento Guasto] --> B{Tipo di Errore?}
    B -- Configurazione Errata --> C[Ripristino Snapshot Proxmox]
    B -- Update Fallito Add-on --> D[Ripristino Backup Interno HA]
    B -- Crash Hardware/Disco --> E[Ripristino Backup VM da NAS]
    
    C --> F[Sistema Operativo in < 1m]
    D --> G[Servizio Ripristinato]
    E --> H[Nuovo Nodo/Disco Pronto]

💡 Note dell’Ingegnere (Critical Thinking)

Storage Monitoring: Assicurati che la partizione /var su Proxmox abbia spazio sufficiente per ospitare temporaneamente i metadati dei container più grandi durante il backup.
3-2-1 Rule: Mantieni sempre una copia dei backup più critici (es. il file .tar di Home Assistant) su un secondo NAS o su cloud (Google Drive), per proteggerti dal guasto fisico del NAS principale.

Ultimo aggiornamento: {{UPDATE_DATE}} | Tags: #Backup #DisasterRecovery #NFS #LXC #Proxmox #Troubleshooting