Home Assistant

Home Assistant non si avvia dopo un aggiornamento o una modifica: diagnosi e ripristino da backup

Dalla verifica dell'accesso locale al ripristino da backup: la procedura completa dal controllo più sicuro al più invasivo, per recuperare un'istanza che non riparte dopo un aggiornamento o una configurazione andata storta.

Dispositivo: Recupero istanza Home AssistantPiattaforma: Home AssistantLivello: Intermedio✓ Verificata 2 ott 2026

Recupero istanza Home Assistant: Home Assistant non si avvia dopo un aggiornamento o una modifica: diagnosi e ripristino da backup — Copertina editoriale DomotikPro

A cosa serve questa guida

Un aggiornamento finito male, una modifica al file di configurazione o un disco pieno: sono le tre cause più comuni per cui Home Assistant smette di rispondere da un momento all'altro.

Quasi sempre si risolve senza perdere nulla, seguendo un ordine preciso: prima i controlli che non modificano niente, poi la correzione della causa più probabile, infine il ripristino da backup come ultima rete di sicurezza.

Non saltare direttamente al ripristino: nella maggior parte dei casi l'istanza riparte prima, senza perdere configurazione o storico.

Cosa ti serve per continuare

Un computer o uno smartphone collegato alla stessa rete di Home Assistant.
Idealmente un backup recente e il relativo kit di emergenza con la chiave di crittografia (vedi la guida ai backup).
Per i casi più gravi su Home Assistant OS: un monitor e una tastiera da collegare al server, per usare la console locale.

Se il problema è comparso subito dopo aver configurato l'accesso remoto, un router con gestione di rete affidabile come il TP-Link Archer AX55 aiuta a escludere la rete come causa, ma non serve per seguire la guida.

In qualità di Affiliato Amazon ricevo un guadagno dagli acquisti idonei. Il prezzo per l'utente non cambia.

Fase 1: Osserva, prima di agire

Il primo passo è capire in che stato si trova l'istanza, senza modificare nulla.

Da un dispositivo della rete di casa apri l'indirizzo locale: http://homeassistant.local, http://homeassistant.local:8123 oppure l'indirizzo IP del server. Ignora per ora l'indirizzo remoto.
Se la pagina si apre e la dashboard mostra la scheda Modalità di ripristino attivata, Home Assistant non è riuscito a caricare la configurazione: vai a "Se è un errore di configurazione".
Se la pagina si apre normalmente ma qualcosa non va, apri Impostazioni → Sistema → Riparazioni: elenca i problemi rilevati, spesso con un pulsante per risolverli.
Se la pagina non si apre affatto, attendi 10 minuti, poi controlla nel pannello del router che il server compaia tra i dispositivi collegati con un indirizzo IP.
Se il server non compare in rete, scollega e ricollega l'alimentazione una sola volta e attendi un intero ciclo di avvio prima di qualsiasi altra azione.

Annota cosa hai visto (scheda di ripristino, riparazioni, presenza in rete): guida la scelta della correzione nella fase successiva.

Fase 2: Correggi la causa più probabile

Come si presenta	Causa probabile	Cosa fare
Scheda "Modalità di ripristino attivata"	Errore di sintassi YAML o opzione non più valida dopo un aggiornamento.	Correggi il file indicato nei registri, controlla la configurazione e riavvia.
Problemi subito dopo un aggiornamento di Home Assistant	Incompatibilità con un'integrazione della community o modifica non retrocompatibile.	Riavvia in modalità provvisoria; se serve, torna alla versione precedente.
Rallentamenti per settimane, poi blocco	Disco quasi pieno, spesso per il database dello storico.	Libera spazio e riduci la conservazione dei dati.
Blocco dopo aver installato o aggiornato un'app	L'app satura risorse o porte.	Arresta l'app, riavvia e controlla il suo registro.
Avviso di database danneggiato	Spegnimento improvviso durante una scrittura.	Di solito il sistema si ripara da solo: vedi più sotto.

Se è un errore di configurazione

Apri Impostazioni → Sistema → Registri e cerca l'errore più recente: indica il nome del file e il numero di riga.
Apri quel file con l'app File editor o Studio Code Server, se già installate (in modalità di ripristino le app continuano a funzionare), e correggi indentazione, due punti o virgolette alla riga indicata.
Apri Impostazioni → Strumenti → YAML e premi Controlla la configurazione: deve risultare valida.
Riavvia da Impostazioni → menu a tre puntini → Riavvia Home Assistant. Se la scheda di ripristino ricompare, c'è un secondo errore: ripeti dal punto 1.

Se è comparso dopo un aggiornamento

Apri Impostazioni → menu a tre puntini → Riavvia Home Assistant, espandi Altre opzioni e scegli Riavvia Home Assistant in modalità provvisoria: parte senza integrazioni, card e temi della community.
Se in modalità provvisoria tutto funziona, la causa è un componente della community: aggiornalo o rimuovilo da HACS, poi riavvia normalmente. La modalità provvisoria dura solo fino al riavvio successivo.
Se il problema resta, torna alla versione precedente: da Impostazioni → Sistema → Backup ripristina il backup creato automaticamente prima dell'aggiornamento, oppure dalla console esegui ha core update --version seguito dal numero della versione precedente (es. 2026.8.3).

Su Home Assistant OS un aggiornamento del sistema operativo che non si avvia viene annullato da solo: dopo alcuni tentativi falliti il sistema riparte dalla versione precedente. Se il sistema parte ma si comporta male, dalla console ha os boot-slot other riavvia sulla versione precedente del sistema operativo.

Se il disco è pieno o il database è cresciuto troppo

Apri Impostazioni → Sistema → Archiviazione e controlla lo spazio libero.
Apri Impostazioni → Sistema → Riparazioni, menu a tre puntini → Informazioni di sistema, e leggi nella sezione Recorder la dimensione stimata del database.
Elimina i backup vecchi da Impostazioni → Sistema → Backup, tenendone almeno uno recente e una copia esterna.
Riduci i giorni di storico conservati (purge_keep_days, 10 di default) o escludi le entità che cambiano più spesso: la procedura è nella guida sul database di Home Assistant.

Se il database è danneggiato, Home Assistant lo rinomina in home-assistant_v2.db.corrupt.<data e ora> e ne crea uno nuovo vuoto: riparte da solo, perdendo lo storico ma non la configurazione. Serve però spazio libero per il nuovo database.

Se l'interfaccia non si apre nemmeno dopo l'attesa

Su Home Assistant OS collega monitor e tastiera al server: compare il prompt ha >, la console locale. Funziona anche quando Home Assistant è bloccato e non richiede preparazione.

Scrivi core logs e leggi le ultime righe: di solito indicano l'integrazione o il file che blocca l'avvio.
Scrivi core restart --safe-mode per avviare in modalità provvisoria, poi riapri l'indirizzo locale dal browser.
Se serve tornare indietro di versione, scrivi core update --version seguito dal numero della versione precedente.
Per ripristinare un backup dalla console: backups list mostra i backup con il loro identificativo, backups restore seguito dall'identificativo lo ripristina.

In alternativa, se l'app Samba share era già attiva, puoi creare un file vuoto chiamato safe-mode nella cartella di configurazione e riavviare: Home Assistant parte in modalità provvisoria e cancella il file da solo.

Fase 3: Se nulla ha funzionato, ripristina un backup

Se l'interfaccia si apre, vai in Impostazioni → Sistema → Backup, apri I miei backup, seleziona il backup giusto e premi Ripristino.
Scegli se ripristinare tutto o solo i dati di Home Assistant, conferma e attendi il riavvio automatico; poi accedi con le credenziali in uso al momento del backup.
Se l'interfaccia non si apre e la console non basta, reinstalla Home Assistant OS sullo stesso supporto o su uno nuovo, seguendo la guida all'installazione.
Alla schermata Benvenuto! scegli Oppure ripristina, poi Carica un backup (file .tar dal computer) oppure Home Assistant Cloud se il backup è salvato lì.
Quando richiesto, inserisci la chiave di crittografia presa dal kit di emergenza e conferma il ripristino.

Verifica e test operativo

Apri Panoramica e aziona un interruttore: il dispositivo deve rispondere.
Apri Impostazioni → Automazioni e scenari e controlla che le automazioni siano presenti e attive.
Apri Impostazioni → Sistema → Riparazioni: non devono esserci nuovi errori legati al problema iniziale.

Cosa fare se qualcosa non funziona

Sintomo	Controllo	Azione
Il ripristino resta fermo a lungo	Dimensione del backup e spazio libero sul disco.	Attendi in proporzione alla dimensione; se non avanza per oltre un'ora, riavvia e prova un backup diverso.
La modalità di ripristino ricompare dopo la correzione	Errore in un file incluso con `!include`.	Rileggi i registri dopo ogni riavvio: mostrano il primo errore trovato, non tutti insieme.
Il comando `ha` non esiste	Usi Home Assistant Container, che non ha il Supervisor.	Controlla la configurazione con `docker exec homeassistant python -m homeassistant --script check_config -c /config` e torna indietro avviando l'immagine Docker della versione precedente.
Il file di backup non viene accettato	Copia incompleta del file `.tar`.	Ricopialo dalla posizione originale e ripeti il ripristino.

Requisiti e risorse ufficiali

Verifica sulla documentazione e sul codice di Home Assistant 2026.9: 2 ottobre 2026.