Home Assistant
HACS: Custom component hacs not loaded during startup ed errore caricamento all'avvio
HACS non viene caricato all'avvio e sparisce dalla barra laterale: la guida legge l'errore reale, controlla i file e reinstalla l'ultima versione senza perdere integrazioni e card già scaricate.
A cosa serve questa guida
HACS è un'integrazione personalizzata: i suoi file stanno nella cartella custom_components/hacs della configurazione. Se all'avvio Home Assistant segnala che HACS non è stato caricato, la voce sparisce dalla barra laterale e non puoi più aggiornare integrazioni e card della community.
Le cause più frequenti sono tre: file mancanti o incompleti dopo un aggiornamento interrotto, una versione di HACS troppo vecchia per la versione di Home Assistant appena installata, oppure un problema di rete verso GitHub. Questa guida le distingue leggendo l'errore reale e reinstalla HACS senza perdere ciò che hai scaricato.
Cosa ti serve per continuare
- Home Assistant OS con l'app Terminal & SSH (oppure accesso al container su Home Assistant Container).
- L'account GitHub usato per autorizzare HACS, nel caso serva ripetere l'autorizzazione.
Fase 1: Leggi l'errore reale
Il messaggio esatto indica la causa: non reinstallare finché non l'hai letto.
- Apri Impostazioni → Sistema → Registri e scrivi
hacsnella ricerca. - Se l'errore parla di integrazione non trovata o di file mancanti (per esempio
Integration 'hacs' not found), i file sono incompleti: vai alla Fase 2. - Se l'errore cita versioni, requisiti o un'eccezione Python comparsa subito dopo un aggiornamento di Home Assistant, la versione di HACS è troppo vecchia: vai direttamente alla Fase 3 per installare l'ultima versione.
Fase 2: Controlla i file installati
Lavori nel terminale dell'app Terminal & SSH: Impostazioni → Applicazioni → Terminal & SSH → Apri interfaccia utente Web.
- Digita
ls -l /config/custom_components/hacs/manifest.json: il file deve esistere e avere una dimensione diversa da zero. - Digita
grep '"version"' /config/custom_components/hacs/manifest.jsone annota la versione installata, per confrontarla con l'ultima pubblicata su github.com/hacs/integration.
Se la cartella manca, è vuota o il file pesa 0 byte, l'installazione è incompleta: prosegui con la Fase 3.
Fase 3: Reinstalla l'ultima versione di HACS
La reinstallazione sostituisce solo i file di HACS: integrazioni, card e temi già scaricati restano dove sono.
- Su Home Assistant OS apri Impostazioni → Applicazioni → Get HACS (se l'hai rimossa, reinstallala seguendo la guida all'installazione di HACS), premi Avvia e attendi nel Registro il messaggio di completamento.
- In alternativa, dal terminale dell'app Terminal & SSH:
cd /confige poiwget -O - https://get.hacs.xyz | bash -. Su Home Assistant Container esegui lo stesso comando dentro il container, dopodocker exec -it homeassistant bash. - Riavvia completamente da Impostazioni → menu a tre puntini → Riavvia Home Assistant: ricaricare la configurazione YAML non basta.
- Ricarica il browser forzando l'aggiornamento (Ctrl+F5 o Cmd+Shift+R). Se HACS non compare tra le integrazioni configurate, aggiungilo da Impostazioni → Dispositivi e servizi → Aggiungi integrazione → HACS e autorizza di nuovo GitHub con il codice su
https://github.com/login/device.
Verifica e test operativo
- Apri HACS e cerca un repository qualsiasi, per esempio una card molto diffusa: deve comparire nei risultati.
- Usa il filtro di stato per mostrare i componenti scaricati: devono esserci ancora quelli installati prima del problema.
Cosa fare se qualcosa non funziona
| Sintomo | Controllo | Azione |
|---|---|---|
| HACS non compare nemmeno dopo il riavvio | manifest.json presente e non vuoto. | Elimina la cartella con rm -rf /config/custom_components/hacs, ripeti la Fase 3 e riavvia. |
| Il codice di autorizzazione GitHub scade | Il codice resta valido pochi minuti. | Chiudi la finestra, ripeti Aggiungi integrazione → HACS per un nuovo codice e inseriscilo subito. |
| HACS si apre ma i repository non si caricano | Nei registri compaiono errori di rete o di limite di richieste verso GitHub. | Controlla la connessione del server; in caso di limite di richieste attendi un'ora e riprova. |
| Dopo la reinstallazione Home Assistant non si avvia | Errore di un'integrazione della community nei registri. | Riavvia in modalità provvisoria e aggiorna o rimuovi quell'integrazione da HACS. |
Requisiti e risorse ufficiali
- HACS: procedura ufficiale di download
- HACS: configurazione dell'integrazione
- HACS: versioni pubblicate
- Se Home Assistant non si avvia: modalità provvisoria e ripristino
Uno storage lento allunga i tempi di avvio ma non è la causa di questo errore. Se vuoi comunque una base più solida di una microSD, un mini PC con SSD come il Beelink MINI S12 Pro Mini PC, Intel N100, 16 GB DDR4, SSD 500 GB riduce sensibilmente i tempi di riavvio.
Verifica sulla documentazione HACS e su Home Assistant 2026.9: 2 ottobre 2026.