🧠 Installazione HACS: Il Community Store

::: info HACS non è un add-on ufficiale, ma una “custom integration”. È lo strumento indispensabile per accedere a migliaia di temi, schede per la dashboard (come le popolari Mushroom Cards) e integrazioni per dispositivi non supportati nativamente. :::

1. Prerequisiti

Prima di iniziare, assicurati di avere:

1. Accesso SSH o Terminale: L’Add-on “Terminal & SSH” deve essere installato e configurato in Home Assistant.
2. Account GitHub: Necessario per l’autenticazione alle API di GitHub (HACS le usa per scaricare i repository).
3. Backup: Esegui uno snapshot su Proxmox prima di procedere.

2. Procedura di Installazione (CLI)

HACS richiede lo scaricamento di uno script di installazione direttamente nel filesystem di Home Assistant.

1. Apri il Terminale (Add-on Terminal & SSH).
2. Esegui il comando ufficiale:

   wget -O - https://get.hacs.xyz | bash -
   

3. Riavvio Obbligatorio: Una volta completato lo script, riavvia Home Assistant:
   • Percorso: Impostazioni -> Sistema -> pulsante Riavvia (in alto a destra).

3. Configurazione dell’Integrazione (GUI)

Dopo il riavvio, HACS deve essere attivato come una normale integrazione.

1. Vai in Impostazioni -> Dispositivi e Servizi.
2. Clicca su Aggiungi Integrazione e cerca HACS.
3. Accettazione Termini: Ti verrà chiesto di confermare di aver capito che HACS è uno strumento della community e che sei responsabile di ciò che installi.
4. Autenticazione GitHub:
   • Apparirà un codice sul display.
   • Vai su https://github.com/login/device e inserisci il codice.
   • Autorizza HACS ad accedere al tuo account.

4. Struttura di HACS

Una volta installato, troverai una nuova voce “HACS” nella barra laterale, divisa in due sezioni principali:

• Integrations: Per scaricare driver di dispositivi o servizi logici (es. Alexa Media Player, Local Tuya).
• Frontend: Per scaricare elementi grafici, temi e card personalizzate (es. Lovelace Mushroom Cards, Card Mod).

📉 Workflow di Installazione (Mermaid)

graph TD
    A[Apertura Terminale SSH] --> B[Esecuzione Script wget]
    B --> C[Riavvio Home Assistant]
    C --> D[Aggiunta Integrazione HACS]
    D --> E[Autorizzazione GitHub]
    E --> F[HACS Pronto all'uso]

💡 Note dell’Ingegnere (Critical Thinking)

• API Rate Limiting: HACS usa le API di GitHub. Senza autenticazione, saresti bloccato quasi subito. L’uso del tuo account GitHub serve a darti un limite di richieste molto più alto.
• Aggiornamenti: HACS ti avviserà quando i componenti installati hanno nuovi update. Tratta questi aggiornamenti con cautela: leggi sempre i “Breaking Changes” prima di aggiornare una custom integration critica.
• Performance: Non esagerare con le card del Frontend. Ogni card custom carica file JavaScript aggiuntivi nel browser; troppe card possono rallentare l’esperienza sulla App mobile.

Ultimo aggiornamento: {{UPDATE_DATE}} | Tags: #HACS #HomeAssistant #CustomIntegrations #GitHub