HACS: Custom component hacs not loaded during startup ed errore caricamento all'avvio

1. A cosa serve

La guida risolve l'errore di mancato caricamento dell'integrazione HACS (Custom component hacs not loaded during startup) al riavvio del server Home Assistant OS.

2. Specifiche e compatibilità

Piattaforma: Home Assistant OS / Container. Requisiti: Account GitHub.com gratuito ed abilitazione dell'integrazione HACS.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. Add-on Terminal & SSH installato. 2. Connessione ad Internet attiva sul server domotico.

Fase 1: Preparazione

Verifica che la cartella /config/custom_components/hacs esista e contenga tutti i file di codice Python scaricati dallo script ufficiale di installazione.

[SCHEMA GRAFICO: Flusso Installazione HACS: Terminale SSH ---> Script wget download.hacs.xyz ---> Cartella /config/custom_components/hacs ---> Riavvio HA Core]

Svuota sempre la cache del browser (CTRL + F5 o CMD + SHIFT + R) dopo l'installazione di HACS per far comparire la voce HACS nella barra laterale sinistra!

Non installare integrazioni custom da repository GitHub sconosciute o non verificate per proteggere la stabilità del sistema operativo.

Fase 2: Configurazione

• Apri il Terminale SSH di Home Assistant. 2. Esegui il comando di download ufficiale: wget -O - https://get.hacs.xyz | bash -. 3. Riavvia completamente Home Assistant da Impostazioni > Sistema > Riavvia. 4. Vai su Impostazioni > Dispositivi e Servizi > Aggiungi Integrazione > cerca HACS. 5. Autenticati con il codice GitHub.

Comando di installazione Bash: wget -O - https://get.hacs.xyz | bash -.

Fase 3: Automazione / Uso pratico

Comando Bash da eseguire nel terminale SSH per la reinstallazione pulita di HACS:

# Script di download ed estrazione di HACS in custom_components
cd /config
wget -O - https://get.hacs.xyz | bash -

Automazione YAML per verificare lo stato di caricamento degli Add-on HACS:

alias: "System - Monitoraggio Caricamento HACS"
trigger:
  - platform: homeassistant
    event: start
condition:
  - condition: state
    entity_id: sensor.hacs
    state: "unavailable"
action:
  - service: notify.persistent_notification
    data:
      title: "⚠️ Errore Caricamento HACS"
      message: "L'integrazione HACS non è stata caricata correttamente all'avvio."

Verifica e test operativo

Apri l'interfaccia di Home Assistant: la voce HACS con la sua icona colorata deve apparire nella barra laterale sinistra ed i repository devono essere consultabili.

La pagina HACS si apre correttamente permettendo la ricerca ed il download delle schede Lovelace e delle integrazioni custom.

Cosa fare se qualcosa non funziona

• HACS non compare tra le integrazioni: Verificare che la cartella custom_components/hacs contenga il file manifest.json. 2. Errore Token GitHub: Rigenerare il codice OTP da github.com/login/device. 3. Core bloccato: Verificare la versione di Home Assistant (HACS richiede HA Core v2024.1+).

9. Sicurezza e privacy

Gestione ed aggiornamento locale di componenti aggiuntivi comunitari open-source.

10. Requisiti e Risorse Ufficiali

Questa guida risolve una problematica tecnica di configurazione o sistema domotico. Di seguito i riferimenti alle documentazioni ufficiali:

* 🌐 Documentazione Ufficiale Home Assistant: [home-assistant.io/help](https://www.home-assistant.io/help/)

* 📦 Repository GitHub Troubleshooting: [github.com/home-assistant/core/issues](https://github.com/home-assistant/core/issues)

* 🛠️ Prerequisiti di sistema: Server Home Assistant OS aggiornato, connessione di rete LAN locale ed accesso Amministratore.