Come spostare i dati di Home Assistant senza perdere utenti, cronologia o impostazioni

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.

Sposta i dati di Home Assistant preservando lo stato completo dell’applicazione e mantenendo intatta la vecchia istanza finché quella sostitutiva non supera una validazione completa.

Utenti e impostazioni non si trovano solo nei file YAML visibili, e la cronologia non viene ricreata copiando una dashboard. Una migrazione deve preservare la directory di configurazione di Home Assistant o un backup supportato, il database Recorder quando la cronologia è importante, lo storage nascosto, i segreti, i componenti personalizzati e le mappature dei dispositivi e della rete specifiche dell’ambiente che li circondano. La sequenza più sicura è inventario, copia coerente, avvio isolato, validazione e infine dismissione dell’origine.

Inventaria lo stato persistente e le dipendenze esterne prima dello spostamento

Per un’installazione Container, considera l’intera directory di configurazione di Home Assistant montata come unità principale di ripristino, invece di selezionare alcuni file familiari. Lo stato nascosto in .storage, i dati di autenticazione, i registri delle integrazioni, le dashboard, le automazioni e il database Recorder predefinito possono trovarsi tutti sotto quel percorso. MariaDB esterno, MQTT, gateway Zigbee, archivi dei segreti o mount NAS devono essere elencati separatamente.

Una guida al trasferimento di un container Home Assistant spiega perché lo spostamento dell’intera directory di configurazione è più sicuro della ricostruzione dello stato file per file e sottolinea l’importanza di arrestare il vecchio container prima di eseguire una copia grezza del filesystem.

Crea un manifesto con percorso di origine, percorso di destinazione, proprietario UID/GID, posizione del database, dispositivi USB o seriali, modalità di rete, porte pubblicate, servizi esterni e versione attuale di Home Assistant. Se una dipendenza non è documentata, non eliminare la vecchia istanza. La migrazione non è pronta finché il nuovo host non è in grado di riprodurre quella dipendenza sulla base di informazioni scritte.

Crea un punto di ripristino coerente prima di copiare i dati

Usa il backup integrato o un altro metodo consapevole dello stato dell’applicazione quando l’installazione lo supporta. Se esegui una copia grezza di un Container, arresta Home Assistant prima di copiare il database di configurazione attivo e i file correlati. Una semplice copia a caldo può acquisire i file dell’applicazione in momenti diversi, l’opposto di una migrazione controllata.

La revisione del sistema di backup di Home Assistant ha esteso il supporto al ripristino tra diversi metodi di installazione, rendendo un backup supportato un solido confine di portabilità quando si cambia ambiente di esecuzione. La lezione pratica del ripristino di backup tra installazioni è che il nuovo ambiente di esecuzione può cambiare, mentre lo stato dell’applicazione rimane il confine di continuità.

Conserva due copie: un punto di ripristino pre-spostamento lasciato intatto e una copia di lavoro utilizzata per la migrazione. Non permettere alla nuova istanza di Home Assistant di avviarsi usando l’unica copia integra dell’origine. Se la destinazione esegue una migrazione o scrive un nuovo stato nei registri, devi comunque disporre di un percorso pulito per tornare alla vecchia versione e al vecchio host.

Ricrea separatamente le mappature hardware e di rete specifiche dell’ambiente di esecuzione

I dati dell’applicazione non ricreano automaticamente i percorsi dei dispositivi host. I coordinatori USB Zigbee o Z-Wave possono comparire con un nome diverso, l’accesso Bluetooth può variare, la rete dell’host può modificare il rilevamento e i database esterni o i broker MQTT possono essere raggiunti tramite indirizzi diversi. Ricrea esplicitamente queste interfacce prima di interpretare un’integrazione non disponibile come una perdita di dati.

Una guida indipendente alla migrazione da Container a HAOS mostra che il ripristino dello stato di Home Assistant Core non ricrea automaticamente i servizi complementari come MQTT, Zigbee2MQTT o Node-RED. La sua sequenza di migrazione con rimappatura dei servizi complementari verifica inoltre la continuità della cronologia Recorder, l’accesso al coordinatore USB e il vecchio stack arrestato ma intatto come percorso di ripristino.

Avvia la destinazione su un percorso LAN controllato ed evita di eseguire entrambe le istanze con le stesse radio, webhook, account cloud o automazioni, a meno che tu non le abbia isolate deliberatamente. Due istanze attive di Home Assistant possono inviare azioni duplicate o competere per lo stesso coordinatore, facendo apparire difettosa una migrazione dei dati corretta.

Convalida utenti, cronologia, impostazioni e controllo dei dispositivi prima del passaggio

Accedi con un account esistente non amministratore, conferma la presenza di un account amministratore, apri i grafici storici relativi al periodo precedente allo spostamento, controlla le integrazioni, attiva automazioni rappresentative e verifica un dispositivo per ogni protocollo importante. Poi riavvia Home Assistant e riavvia l’host di destinazione per dimostrare che lo stato ripristinato sopravvive ai normali eventi del ciclo di vita.

La spiegazione di ZimaSpace sui ruoli dei dati persistenti di Home Assistant fornisce un utile confine di ripristino: identità, configurazione e cronologia durevoli devono essere trattate diversamente dai file di cache o temporanei durante uno spostamento.

Modifica DNS, proxy o accesso remoto solo dopo che i test locali hanno avuto esito positivo. Mantieni il vecchio host spento ma recuperabile per almeno un normale ciclo di utilizzo. Dismettilo solo quando utenti, cronologia, impostazioni, automazioni, radio, servizi esterni, creazione dei backup e riavvio funzionano tutti come previsto; il caricamento corretto della prima dashboard non è una prova sufficiente per eliminare il percorso di ripristino.

Supporto e consigli

Altro da leggere

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.