Per prevenire la perdita della configurazione di Home Assistant, usa il sistema di backup integrato come percorso di ripristino principale e considera il runtime sostituibile. La versione di Home Assistant, l'immagine del container o l'host possono cambiare; il backup, la chiave di crittografia, la definizione del runtime e tutte le dipendenze esterne devono comunque essere disponibili quando la macchina originale non c'è più.
I backup moderni di Home Assistant funzionano con tutti i tipi di installazione, incluso Container. Conserva una copia manuale separata dell'albero di configurazione se può essere utile, ma non basare l'intero piano di aggiornamento sulla copia manuale dei file ignorando il flusso di lavoro supportato per il backup e il ripristino.
Inizia con un backup integrato, non con una cartella YAML copiata a mano
Non ridurre la «configurazione» a configuration.yaml. Il sistema di backup supportato da Home Assistant acquisisce lo stato dell'applicazione necessario al ripristino, compresi la configurazione e i contenuti del database, mentre i flussi di lavoro di backup più recenti supportano anche l'automazione, la conservazione e le destinazioni esterne all'host.
La revisione dei backup introdotta nel 2025 ha aggiunto backup crittografati automatici, controlli di conservazione e destinazioni di backup esterne. Per questo, prima di un aggiornamento, è meglio verificare il backup integrato come prima risorsa di ripristino, invece di affidarsi a una copia manuale incompleta.
Registra comunque la directory principale della configurazione, il database scelto, i riferimenti ai segreti, i componenti personalizzati, i materiali SSL e gli eventuali file o servizi esterni richiesti da un'integrazione. Un backup può ripristinare lo stato di Home Assistant senza documentare automaticamente ogni dispositivo USB, percorso di rete, host del database o parametro del container.
Rendi esplicite la persistenza del container e le impostazioni di runtime
Per Docker, verifica il bind mount o il volume associato a /config e conserva la definizione Compose o run che ricrea la modalità di rete, le mappature dei dispositivi, il fuso orario, i privilegi e i servizi esterni. Il file system del container deve rimanere sacrificabile.
Una discussione sui backup di Home Assistant Docker mostra chiaramente il problema: quando gli utenti mappano solo un file invece dell'intera directory di configurazione, dati importanti possono rimanere intrappolati nel container e andare persi quando il runtime viene sostituito.
Verifica il mount dell'host prima dell'aggiornamento e conserva la definizione del runtime accanto al backup. Il ripristino è molto più rapido quando sono già noti sia lo stato dell'applicazione sia le istruzioni necessarie per esporre radio, porte, reti e spazio di archiviazione.
Sposta almeno un backup crittografato fuori dall'host
Un backup sullo stesso SSD protegge da alcuni errori di configurazione, ma non dalla perdita dell'host, dalla corruzione del file system, dal furto o dal guasto di un dispositivo di archiviazione. Conserva almeno una copia di ripristino su un NAS, un altro computer o una destinazione di backup remota, il cui accesso non dipenda dall'host Home Assistant guasto.
Conserva anche la chiave di cifratura del backup o il kit di emergenza al di fuori di Home Assistant. In Home Assistant 2026.4, i nuovi backup cifrati sono passati al formato SecureTar v3 sottoposto ad audit, con una cifratura moderna più robusta, che migliora la sicurezza dei backup ma rende la custodia delle chiavi una componente esplicita della possibilità di ripristino.
Crea versioni separate del backup invece di sovrascrivere sempre lo stesso file. Un aggiornamento può rivelare un problema giorni dopo e il punto di ripristino più recente potrebbe già contenere lo stato migrato o danneggiato da cui stai cercando di tornare indietro.
Il backup non sostituisce comunque la definizione dell'ambiente di esecuzione
La sola configurazione potrebbe non ripristinare le radio USB, la rete dell'host, il fuso orario, il passthrough dei dispositivi, i servizi di database, MQTT o le relazioni con il reverse proxy. Conserva il file Compose, i criteri per le versioni delle immagini, le variabili d'ambiente, i percorsi host, le mappature dei dispositivi e le dipendenze tra i servizi necessarie per ricreare l'ambiente di esecuzione.
Non inserire segreti in chiaro in un repository pubblico solo per tenere traccia delle versioni del file Compose. Conserva i valori dei segreti in un luogo protetto e documenta soltanto dove la procedura di ripristino li recupera.
La guida alla distribuzione di Home Assistant su ZimaBoard di ZimaSpace è un utile riferimento per distinguere la piattaforma home server dallo stato dell'applicazione che deve sopravvivere ai futuri cambiamenti di distribuzione.
Esegui un test di ripristino prima che l'aggiornamento diventi un'emergenza
Un backup non è verificato solo perché l'archivio esiste. Ripristinalo su un sistema isolato o in un container temporaneo, ricollega i dispositivi e i percorsi rappresentativi, se possibile, e verifica che il sistema torni operativo con utenti, dashboard, integrazioni, automazioni, helper e lo stato previsto.
Usa il test per individuare password mancanti, percorsi host obsoleti, mappature dei dispositivi non documentate e database troppo grandi mentre il sistema di produzione funziona ancora. Dopo il test riuscito, annota i passaggi di ripristino: la memoria non è un piano di ripristino.
Subito prima dell'aggiornamento, crea un nuovo punto di ripristino, annota la versione attuale di Home Assistant e dell'immagine del container e controlla le modifiche della release che riguardano le tue integrazioni. Mantieni disponibile l'ambiente di esecuzione precedente finché l'istanza aggiornata non supera sia un normale periodo di utilizzo sia un riavvio.
Usa un controllo di sicurezza in quattro parti prima dell'aggiornamento
| Risorsa di ripristino | Cosa protegge | Conseguenze in caso di assenza |
|---|---|---|
| Backup integrato | Configurazione di Home Assistant e stato dell'applicazione ripristinabile | Nessun punto di ripristino supportato |
| Chiave di cifratura / kit di emergenza | Accesso ai backup protetti | Il backup esiste ma non può essere aperto |
| Definizione dell'ambiente di esecuzione | Mount, dispositivi, rete, ambiente | Stato corretto ma accesso al servizio compromesso |
| Copia esterna all'host + test di ripristino | Guasto dell'host e validità della procedura | Il ripristino viene meno insieme all'ambiente di produzione o fallisce quando serve |
Aggiorna solo quando possiedi tutte e quattro le parti. Una copia manuale dell'albero di configurazione può restare un livello aggiuntivo, ma il piano di ripristino principale dovrebbe basarsi su un backup supportato che puoi decrittare e ripristinare insieme a un ambiente di esecuzione documentato.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



