Come ripristinare in sicurezza Home Assistant dopo un aggiornamento incompatibile

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.

Ripristina Home Assistant a una versione precedente utilizzando un punto di ripristino creato prima dell’aggiornamento e compatibile con la versione precedente di Core; non presumere che avviare un runtime meno recente annulli le migrazioni più nuove dello stato persistente.

Il rollback più sicuro inizia prima del primo tentativo di riparazione: conserva lo stato successivo all’aggiornamento non riuscito, individua l’ultima versione funzionante e il relativo backup, quindi stabilisci se l’incompatibilità riguarda Core, un’integrazione personalizzata, un add-on o un database esterno. Un rollback ha successo solo quando il runtime precedente riesce a leggere lo stato ripristinato e le funzioni originali della casa tornano a funzionare. Cambiare versione e ripristinare i dati sono un’unica operazione di recupero, non due pulsanti indipendenti.

Conserva lo stato non riuscito prima di tentare il downgrade

Non sovrascrivere l’unica copia della configurazione successiva all’aggiornamento mentre fai delle prove. Salva la configurazione attuale, i log, i numeri di versione, la posizione del database e la funzione esatta che si è interrotta. Questa copia potrebbe contenere modifiche effettuate dopo l’ultimo backup funzionante e informazioni utili per comprendere in seguito l’incompatibilità.

Una regressione del ripristino del 2026 ha dimostrato che persino un ripristino del backup apparentemente riuscito può lasciare il runtime sulla versione sbagliata quando il comportamento del Supervisor circostante presenta problemi. La segnalazione relativa al ripristino del backup e al rollback della versione di Core è un valido motivo per verificare la versione effettiva dopo il ripristino, invece di fidarsi del messaggio di completamento.

Smetti di apportare modifiche alla configurazione finché non hai definito il percorso di recupero. Se l’aggiornamento ha danneggiato un solo componente personalizzato opzionale mentre il resto di Home Assistant è stabile, disabilitare quel componente potrebbe essere più sicuro di un rollback completo. Se Core non si avvia, il database non viene caricato o le automazioni critiche non sono utilizzabili, passa al percorso di recupero abbinato di runtime e stato.

Scegli un punto di ripristino precedente alla versione incompatibile

Individua l’ultimo backup eseguito mentre la versione precedente di Home Assistant funzionava correttamente. Confronta il relativo timestamp con le modifiche importanti ad automazioni, utenti, dashboard o cronologia che sei disposto a perdere. Il punto di ripristino comporta un compromesso: ristabilisce la compatibilità riportando indietro nel tempo lo stato persistente.

Le indicazioni di ZimaSpace su come creare uno snapshot dei dati delle app prima di un aggiornamento rappresentano la versione preventiva della stessa regola: il rollback del runtime è più semplice quando esiste una copia dello stato funzionante risalente a prima che il nuovo software scrivesse per la prima volta sui dati di produzione.

Se non esiste un backup precedente all’aggiornamento di cui ti fidi, non crearne uno copiando il database già migrato e associandolo a un’immagine precedente di Core. Conserva lo stato attuale e valuta una correzione in avanti o una ricostruzione controllata. Un rollback senza una copia dello stato compatibile può trasformare una singola funzione incompatibile in problemi di Recorder, cronologia o registro.

Ripristina runtime e stato persistente come coppia abbinata

Per Home Assistant OS o un’installazione gestita, utilizza il percorso di ripristino supportato che recupera il punto di ripristino selezionato e verifica che venga effettivamente avviata la versione di Core desiderata. Per le installazioni basate su Container, ripristinare l’immagine è solo metà dell’operazione se la versione più recente ha modificato i dati persistenti; ripristina anche la copia della configurazione corrispondente a prima dell’aggiornamento.

Un problema di Home Assistant Core relativo al downgrade dalla versione 2025.4 alla 2025.3 ha documentato il malfunzionamento di Recorder, cronologia e integrazioni correlate quando il runtime precedente incontrava una struttura del database più recente. La risposta del manutentore afferma esplicitamente che il rollback dipende dal ripristino di un backup, non da un percorso di downgrade del database in loco.

Ripristina database esterni e servizi dipendenti a punti compatibili solo quando il backup di Home Assistant non li include. Non riportare ciecamente indietro tutti i container. MQTT, proxy e radio potrebbero funzionare correttamente e possono rimanere invariati; concentra il rollback sui componenti il cui contratto di versione o di stato è effettivamente cambiato.

Verifica il problema originale prima di riattivare gli aggiornamenti automatici

Dopo il rollback, conferma la versione di Core in esecuzione, l’accesso, Recorder/cronologia, le integrazioni principali, le automazioni, le dashboard e un dispositivo per ogni protocollo critico. Ripeti l’azione che aveva generato l’errore nella versione incompatibile e verifica che ora funzioni senza nuovi errori. Quindi riavvia Home Assistant e riavvia una volta il dispositivo host.

Conserva la copia dello stato non riuscito e le note sull’aggiornamento fino a quando la versione o la correzione successiva non sarà stata testata. Se l’incompatibilità è stata causata da un’integrazione personalizzata, controlla le versioni supportate prima del prossimo aggiornamento di Core. Se anche il rollback non riesce, non alternare ripetutamente le versioni sullo stesso database modificabile; torna al punto di ripristino pulito oppure procedi con una ricostruzione e un ripristino selettivo.

Considera l’operazione riuscita quando la versione precedente e lo stato ripristinato rimangono stabili durante l’uso normale e dopo un riavvio, e il problema originale è scomparso. Richiedi assistenza quando il backup non può essere ripristinato, il runtime precedente continua a non riuscire a leggere il proprio stato o i dati critici non dispongono di un punto di recupero compatibile. A quel punto, una correzione controllata in avanti o una ricostruzione è più sicura di ulteriori tentativi di downgrade.

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.