Come prevenire la perdita della configurazione di Home Assistant durante gli aggiornamenti

Eva Wong

IceWhale author

Eva Wong è la Technical Writer e smanettatrice residente di ZimaSpace. Una geek da sempre con una passione per homelab e software open-source, si specializza nel tradurre concetti tecnici complessi in guide accessibili e pratiche. Eva crede che l'auto-ospitare debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, dà potere alla comunità di demistificare le configurazioni hardware, dalla costruzione del loro primo NAS al dominio dei container Docker.

How to Prevent Home Assistant Configuration Loss During Upgrades - Zima Store Online

Previeni la perdita della configurazione di Home Assistant rendendo il sistema di backup integrato il principale percorso di ripristino e trattando il runtime come 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 essere ancora disponibili quando la macchina originale non è più utilizzabile.

I backup moderni di Home Assistant funzionano con tutti i tipi di installazione, incluso Container. Conserva una copia manuale separata dell’albero di configurazione quando può essere utile, ma non basare l’intero piano di aggiornamento sulla copia manuale dei file ignorando il flusso di backup e ripristino supportato.

Inizia con un backup integrato, non con una cartella YAML copiata manualmente

Non ridurre la “configurazione” a configuration.yaml. Il sistema di backup supportato da Home Assistant acquisisce lo stato dell’applicazione necessario per il ripristino, inclusi configurazione e contenuti del database, mentre i flussi di backup più recenti supportano anche automazione, conservazione e destinazioni esterne all’host.

La revisione del sistema di backup introdotta nel 2025 ha aggiunto backup automatici crittografati, controlli di conservazione e destinazioni di backup esterne. Questo rende il backup integrato il primo elemento di ripristino da verificare prima di un aggiornamento, invece di affidarsi a una copia manuale incompleta.

Annota comunque la radice della configurazione, il database utilizzato, i riferimenti ai segreti, i componenti personalizzati, il materiale SSL e tutti i 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 che lo circonda.

Rendi esplicite la persistenza del container e le impostazioni del runtime

Per Docker, verifica il bind mount o il volume che contiene /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 filesystem del container deve rimanere temporaneo.

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, uno stato importante può rimanere intrappolato nel container e scomparire quando il runtime viene sostituito.

Verifica il mount dell’host prima dell’aggiornamento e conserva la definizione del runtime insieme al backup. Il ripristino è molto più rapido quando sia lo stato dell’applicazione sia le istruzioni necessarie per esporre radio, porte, reti e spazio di archiviazione sono già noti.

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 filesystem, dal furto o dal guasto del dispositivo di archiviazione. Conserva almeno una copia di ripristino su un NAS, su un altro computer o in una destinazione remota, il cui accesso non dipenda dall’host Home Assistant guasto.

Conserva anche la chiave di crittografia del backup o il kit di emergenza al di fuori di Home Assistant. Home Assistant 2026.4 ha spostato i nuovi backup crittografati nel formato SecureTar v3 sottoposto ad audit, con una crittografia moderna più robusta. Questo migliora la sicurezza dei backup, ma rende la gestione delle chiavi una parte esplicita della possibilità di ripristino.

Conserva le versioni del backup invece di sovrascrivere sempre lo stesso file. Un aggiornamento può rivelare un problema dopo diversi giorni e il punto di ripristino più recente potrebbe contenere già lo stato migrato o danneggiato da cui stai cercando di uscire.

Featured

ZimaCube 2 NAS personale cloud domestico

ZimaCube2

Il backup non sostituisce comunque la definizione del runtime

La sola configurazione potrebbe non ripristinare radio USB, rete dell’host, fuso orario, passthrough dei dispositivi, servizi di database, MQTT o relazioni con il reverse proxy. Conserva il file Compose, la politica delle versioni delle immagini, le variabili d’ambiente, i percorsi dell’host, le mappature dei dispositivi e le dipendenze dei servizi necessarie per ricreare il runtime.

Non inserire segreti in chiaro in un repository pubblico solo per versionare il file Compose. Conserva i valori segreti in una posizione protetta e documenta soltanto dove il processo di ripristino li recupera.

La guida alla distribuzione di Home Assistant su ZimaBoard di ZimaSpace è un utile riferimento per separare 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 una destinazione isolata o in un container temporaneo, ricollega quando possibile dispositivi e percorsi rappresentativi e conferma che il sistema torni operativo con utenti, dashboard, integrazioni, automazioni, helper e stato previsto.

Usa il test per individuare password mancanti, percorsi dell’host obsoleti, mappature dei dispositivi non documentate e database eccessivamente grandi mentre il sistema di produzione funziona ancora. Dopo il test riuscito, annota i passaggi di ripristino: la memoria non è un piano di recupero.

Subito prima dell’aggiornamento, crea un nuovo punto di ripristino, annota la versione corrente di Home Assistant e dell’immagine del container e verifica le modifiche della release che riguardano le tue integrazioni. Mantieni disponibile il runtime precedente finché l’istanza aggiornata non supera sia un normale periodo di utilizzo sia un riavvio.

Usa un controllo di sicurezza dell’aggiornamento in quattro parti

Elemento di ripristino	Cosa protegge	Problema in caso di assenza
Backup integrato	Configurazione di Home Assistant e stato recuperabile dell’applicazione	Nessun punto di ripristino supportato
Chiave di crittografia / kit di emergenza	Accesso ai backup protetti	Il backup esiste, ma non può essere aperto
Definizione del runtime	Mount, dispositivi, rete, ambiente	Stato corretto, ma accesso al servizio non funzionante
Copia fuori dall’host + test di ripristino	Guasto dell’host e validità della procedura	Il ripristino scompare con la produzione o non funziona quando serve

Esegui l’aggiornamento solo quando tutti e quattro gli elementi sono sotto controllo. Una copia manuale dell’albero di configurazione può rimanere un livello aggiuntivo, ma il piano di ripristino principale dovrebbe essere un backup supportato che puoi decrittografare e ripristinare insieme a un runtime documentato.