Home Assistant lento: cause e ottimizzazioni

Se il tuo sistema di domotica risponde in ritardo ai comandi o l'interfaccia utente impiega secondi preziosi per caricarsi, è il momento di ottimizzare Home Assistant. Questa guida è dedicata a utenti di livello intermedio e copre i controlli preliminari fino agli interventi avanzati su database e storage. Prerequisiti: accesso amministrativo a Home Assistant Core (almeno versione 2023.x o successive) e familiarità con l'interfaccia di configurazione e i file di log. Limiti: le modifiche al database o al file configuration.yaml richiedono attenzione e un backup preventivo. Nota di sicurezza: se gestisci automatismi critici legati a riscaldamento, serrature o allarmi di sicurezza, esegui le modifiche in orari di minor carico e tieni pronta una modalità di controllo manuale.

Analisi dell'hardware e dello storage

Il collo di bottiglia più comune in Home Assistant riguarda il supporto di memorizzazione, in particolare l'uso di schede microSD economiche su Raspberry Pi. Le operazioni di scrittura continua del database degradano rapidamente le prestazioni delle schede SD, portando a corruzioni e rallentamenti estremi dell'I/O su disco.

Verifica dello stato del disco e della CPU

Accedi a Impostazioni > Sistema > Hardware oppure usa l'add-on Glances o HassOS SSH per monitorare l'utilizzo della CPU, della RAM e la percentuale di occupazione del disco. Se la memoria RAM è satura o la CPU rimane costantemente sopra l'80% senza carichi apparenti, l'hardware attuale potrebbe non essere sufficiente per il numero di integrazioni installate.

Migrazione da SD a SSD

Il passaggio da scheda microSD a un disco a stato solido (SSD) collegato tramite adattatore USB alimentato migliora drasticamente la reattività generale del sistema, riducendo i tempi di avvio e velocizzando le query al database. Per un'esperienza d'uso ottimale e pronta all'uso, ti consigliamo di installare Home Assistant Green.

Ottimizzazione del database recorder e dei log

Il componente recorder di Home Assistant salva ogni cambiamento di stato di sensori, luci e dispositivi. Senza una configurazione mirata, il database SQLite cresce a dismisura, appesantendo ogni operazione di lettura e scrittura.

Ridurre la retention del database

Di default, Home Assistant conserva i dati per 10 giorni. Se hai centinaia di entità, questo periodo è eccessivo. Modifica il file configuration.yaml per ridurre i giorni di conservazione:

recorder:
  purge_keep_days: 7
  auto_purge: true

Esclusione di entità inutili

Non tutte le entità richiedono lo storico. Escludi sensori ad alta frequenza (come i livelli della batteria aggiornati ogni minuto o coordinate GPS continue) aggiungendo filtri specifici nella sezione recorder:

recorder:
  exclude:
    domains:
      - updater
    entities:
      - sensor.current_cpu_temperature
      - sun.sun

Gestione dei log di sistema

Un file home-assistant.log troppo grande consuma risorse disco. Imposta il livello di log su warning per le integrazioni stabili, riservando il livello debug solo temporaneamente durante la risoluzione dei problemi.

Integrazioni pesanti, polling e rete

Molti rallentamenti dipendono da integrazioni che interrogano i dispositivi locali o cloud con frequenza eccessiva (polling) o da problemi di connettività di rete.

Identificare le integrazioni lente

Dalla versione recente di Home Assistant, puoi monitorare l'impatto delle integrazioni sulle prestazioni tramite Impostazioni > Sistema > Riparazioni o analizzando i log di avvio alla ricerca di avvisi relativi a componenti che impiegano troppo tempo a rispondere.

Ottimizzazione delle reti Zigbee, Z-Wave e Wi-Fi

Interferenze sulla banda a 2.4 GHz possono rallentare le reti Zigbee e i dispositivi smart Wi-Fi locali. Assicurati che il canale Wi-Fi del tuo router non si sovrapponga a quello del coordinatore Zigbee. Sostituisci, ove possibile, i dispositivi basati su Cloud API con integrazioni locali per azzerare la dipendenza dalla latenza di Internet.

Add-on e risorse di sistema

L'uso massiccio di add-on come broker MQTT, server multimediali, database esterni (es. MariaDB) o sistemi di videosorveglianza (es. Frigate) richiede risorse dedicate.

Valutazione degli add-on

Verifica il consumo di risorse di ciascun add-on dalla scheda Impostazioni > Add-on. Se utilizzi SQLite integrato e riscontri rallentamenti ciclici durante i salvataggi automatici, valuta la migrazione all'add-on ufficiale MariaDB, progettato per gestire carichi di lavoro più intensi in modo efficiente.

Procedura passo dopo passo

1. Esegui un backup completo del sistema da Impostazioni > Sistema > Backup e scaricalo in locale prima di iniziare qualsiasi ottimizzazione.
2. Controlla l'utilizzo di CPU, RAM e spazio su disco in Impostazioni > Sistema > Hardware per individuare colli di bottiglia evidenti.
3. Verifica il file home-assistant.log per identificare errori ripetuti o integrazioni che generano avvisi di rallentamento.
4. Riduci il periodo di conservazione dello storico dei dati nel file configuration.yaml impostando purge_keep_days a un valore inferiore, come 5 o 7 giorni.
5. Escludi dal recorder i sensori ad alta frequenza e le entità superflue che non necessitano di tracciamento a lungo termine.
6. Verifica che non vi siano aggiornamenti critici in sospeso per il Core, i Supervisor e le integrazioni principali.
7. Riavvia Home Assistant per applicare le modifiche alla configurazione e monitora i tempi di boot e la reattività dell'interfaccia.

Verifica del risultato

Per confermare che l'intervento abbia avuto successo, confronta i tempi di caricamento dell'interfaccia utente (Lovelace) prima e dopo le modifiche. Verifica nel log di sistema che il tempo di avvio (startup time) si sia ridotto e che non compaiano più avvisi relativi a task bloccati o timeout delle integrazioni. Monitora l'andamento della CPU per almeno 24 ore successive.

Problemi comuni

Domande frequenti

Passare a un SSD risolve tutti i problemi di lentezza?

Un SSD migliora drasticamente le prestazioni di lettura e scrittura, risolvendo i colli di bottiglia legati all'I/O del disco. Tuttavia, se la lentezza è causata da una CPU sovraccarica o da integrazioni scritte male, l'SSD da solo potrebbe non bastare.

Ogni quanto tempo dovrei pulire il database recorder?

Se utilizzi auto_purge: true con un numero di giorni di conservazione adeguato (ad esempio 7 giorni), Home Assistant esegue la pulizia automaticamente ogni notte, evitando accumuli eccessivi.

Le automazioni complesse rallentano il sistema?

Sì, automazioni scritte con cicli complessi, template estensivi non ottimizzati o trigger ripetuti inutilmente possono aumentare il carico sulla CPU. È consigliabile rivedere la logica delle automazioni più pesanti.

Come posso capire quale integrazione sta rallentando Home Assistant?

Controlla la sezione dei log di avvio e le notifiche in Impostazioni > Riparazioni. Spesso Home Assistant segnala autonomamente le integrazioni che superano i limiti di tempo nell'inizializzazione o nell'aggiornamento dello stato.