Perché Home Assistant perde l'accesso ai dati persistenti dopo la ricreazione dello stack?

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.

Why Does Home Assistant Lose Access to Persistent Data After Stack Recreation?

Ricreare uno stack Docker o Compose di Home Assistant non dovrebbe cancellare la configurazione quando gli stessi dati persistenti di /config vengono montati nuovamente. Quando durante la configurazione iniziale vengono visualizzate nuove schermate o alcune integrazioni sembrano mancanti dopo la ricreazione, si dovrebbe presumere innanzitutto che il nuovo container stia visualizzando una vista di archiviazione diversa, non che Home Assistant abbia eliminato lo stato della casa.

Controlla il montaggio effettivo, il percorso sull'host, il volume denominato, i file nascosti e i permessi prima di ripristinare un backup precedente. Una directory vuota errata può sembrare esattamente una perdita della configurazione, mentre i dati originali sono ancora intatti in un'altra posizione sull'host.

Verifica cosa è effettivamente montato in /config

Controlla il container in esecuzione e conferma l'origine del montaggio associata a /config. Confrontala con il vecchio file Compose o con il registro della distribuzione, invece di affidarti a un nome di cartella dall'aspetto familiare.

I montaggi bind di Docker sostituiscono la vista del container sulla directory di destinazione, e la documentazione sui montaggi bind segnala che il montaggio di una directory dell'host su un percorso del container non vuoto nasconde i file che erano già presenti. Un percorso di origine vuoto o errato fa quindi vedere a Home Assistant un /config vuoto.

Non eseguire la configurazione iniziale e non iniziare a creare nuove integrazioni finché il montaggio non è stato verificato. Le nuove scritture nella directory errata renderanno il recupero successivo più complicato.

Distingui i montaggi bind dai volumi denominati

Uno stack Compose può usare un percorso esplicito sull'host oppure un volume denominato gestito da Docker. Ricreare un progetto con un nome di progetto, un nome di volume o un percorso diverso può creare un nuovo archivio persistente vuoto, mentre il vecchio volume esiste ancora.

Una guida aggiornata sui volumi Docker spiega che i volumi denominati archiviano i dati indipendentemente dai singoli container e possono essere ricollegati dopo la sostituzione di un container. Rimuovere un container è quindi diverso dal rimuovere o sostituire il relativo archivio persistente.

Elenca i volumi vecchi e nuovi, controlla i relativi punti di montaggio tramite Docker e confronta le date di creazione e i contenuti. Evita i comandi di pulizia finché non sai quale volume contiene lo stato autorevole di Home Assistant.

I file nascosti possono far sembrare completa una copia che invece non lo è

Home Assistant archivia dati importanti gestiti dall'interfaccia in percorsi nascosti come .storage. Una copia dalla shell che usa un carattere jolly come *, oppure un file manager che nasconde i file puntati, può trasferire i file YAML lasciando silenziosamente indietro lo stato critico dei registri e delle integrazioni.

Un caso di migrazione da Docker a Compose del 2025 ha riprodotto esattamente questo problema: un'operazione di copia non aveva incluso o aveva gestito in modo errato lo stato nascosto di Home Assistant, e la migrazione si è stabilizzata solo dopo aver copiato correttamente l'intero albero di configurazione e i metadati.

Confronta gli elenchi delle directory includendo i file nascosti e verifica proprietario, date e presenza delle directory nascoste previste prima di concludere che i dati siano danneggiati.

Featured

ZimaCube 2 NAS personale cloud domestico

ZimaCube2

Controlla i permessi prima di copiare nuovamente i dati

Anche la directory corretta può sembrare inutilizzabile quando il container ricreato non dispone dei permessi per leggerla o scriverci. Questo è comune dopo aver spostato i dati su un nuovo file system, cambiato la modalità di Docker, ripristinato dati da un altro host o modificato le associazioni UID/GID.

Una guida alla risoluzione dei problemi di Docker Engine verificata nel 2026 riconduce questi errori a percorso reale sull'host, UID/GID del container, accesso alle directory padre, modalità di montaggio e confini di sicurezza. Una mancata corrispondenza tra sola lettura e proprietà può impedire a Home Assistant di aggiornare lo stato anche quando i file sono visibili.

Risolvi il problema specifico di proprietà o montaggio invece di applicare permessi di scrittura a chiunque all'intero albero di configurazione.

Ricrea lo stack solo dopo aver verificato il percorso persistente

Usa l'esatta definizione Compose funzionante, il tag dell'immagine, la modalità di rete, i dispositivi e l'origine di /config verificati. Avvia Home Assistant e controlla che utenti, dashboard, integrazioni, automazioni e helper previsti siano nuovamente disponibili prima di consentire migrazioni o nuove modifiche alla configurazione.

Il flusso di recupero di un singolo container di ZimaSpace applica la stessa regola: controllare i montaggi effettivi e ricollegare le dipendenze funzionanti prima di ripristinare o sostituire parti non correlate dello stack.

Se i dati autorevoli sono davvero mancanti, passa al ripristino da backup. Se invece sono presenti ma il nuovo container non riesce a visualizzarli o modificarli, il problema riguarda la mappatura dello storage o i permessi, non la configurazione di Home Assistant in sé.