Come ripristinare Home Assistant in sicurezza dopo una versione incompatibile

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Ripristina una versione precedente di Home Assistant usando un punto di ripristino precedente all’aggiornamento e compatibile con la versione precedente di Core; non dare per scontato che avviare un runtime meno recente annulli le migrazioni più recenti dello stato persistente.

Il ripristino più sicuro inizia prima del primo tentativo di riparazione: conserva lo stato successivo all’aggiornamento che non funziona, individua la versione e il backup più recenti noti come funzionanti e stabilisci se l’incompatibilità riguarda Core, un’integrazione personalizzata, un componente aggiuntivo o un database esterno. Il ripristino riesce solo quando il runtime precedente riesce a leggere lo stato ripristinato e le funzioni domestiche originarie tornano a funzionare. Il cambio di versione e il ripristino dei dati sono un’unica operazione di recupero, non due pulsanti indipendenti.

Conserva lo stato non funzionante prima di provare a tornare alla versione precedente

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

Una regressione del ripristino del 2026 ha dimostrato che, quando il comportamento del Supervisor è anomalo, persino il ripristino apparentemente riuscito di un backup può lasciare il runtime sulla versione sbagliata. La segnalazione sul ripristino del backup e il ritorno alla versione precedente di Core è un buon motivo per verificare la versione effettiva dopo il ripristino, invece di fidarsi del messaggio di completamento.

Non apportare altre modifiche alla configurazione finché non è chiaro come procedere con il ripristino. Se l’aggiornamento ha compromesso un componente personalizzato facoltativo, ma il resto di Home Assistant funziona stabilmente, disattivare quel componente potrebbe essere più sicuro di un ripristino completo. Se Core non si avvia, il database non viene caricato o le automazioni critiche non sono utilizzabili, procedi con il ripristino combinato di runtime e stato.

Scegli un punto di ripristino precedente alla versione incompatibile

Individua l’ultimo backup eseguito quando la versione precedente di Home Assistant funzionava correttamente. Confrontane la data e l’ora con quelle di eventuali modifiche importanti ad automazioni, utenti, dashboard o cronologia che sei disposto a perdere. Il punto di ripristino comporta un compromesso: ripristina la compatibilità riportando indietro nel tempo lo stato persistente.

Le indicazioni di ZimaSpace per creare uno snapshot dei dati delle app prima di un aggiornamento applicano in via preventiva la stessa regola: il ripristino della versione precedente è più semplice quando esiste una copia di uno stato noto come funzionante, creata prima che il nuovo software modifichi per la prima volta i dati di produzione.

Se non esiste un backup affidabile precedente all’aggiornamento, non crearne uno copiando il database già migrato e abbinandolo a una vecchia immagine 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 funzionalità incompatibile in problemi con Recorder, la cronologia o i registri.

Ripristina il runtime e lo stato persistente come coppia compatibile

Per Home Assistant OS o un’installazione gestita, usa la procedura di ripristino supportata, che recupera il punto selezionato, e verifica che si avvii effettivamente la versione di Core prevista. Nelle installazioni 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 quella precedente all’aggiornamento.

Un problema di Home Assistant Core relativo al downgrade dalla versione 2025.4 alla 2025.3 documentava malfunzionamenti di Recorder, della cronologia e delle integrazioni correlate quando il runtime precedente incontrava una struttura del database più recente. La risposta del manutentore afferma esplicitamente che il rollback richiede il ripristino di un backup, non una procedura per retrocedere il database direttamente.

Ripristina i database esterni e i servizi dipendenti a punti compatibili solo se non sono inclusi nel backup di Home Assistant. Non riportare indiscriminatamente indietro tutti i container. MQTT, i proxy e le radio potrebbero funzionare correttamente e rimanere invariati; concentra il rollback sui componenti la cui versione o il cui formato di stato è effettivamente cambiato.

Verifica il problema originale prima di riattivare gli aggiornamenti automatici

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

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

Considera superato il test se la versione precedente e lo stato ripristinato restano stabili durante il normale utilizzo e dopo il riavvio, e il problema originale è risolto. Segnala il caso se il backup non riesce a ripristinare i dati, il runtime precedente non riesce ancora a leggerli o i dati critici non hanno un punto di ripristino compatibile. A quel punto, una correzione controllata in avanti o una ricostruzione è più sicura di ripetuti tentativi di downgrade.

Assistenza e consigli

Altre letture

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.