Installare HACS su Home Assistant: guida passo passo e sicura

A cosa serve questa guida

HACS (Home Assistant Community Store) è un catalogo di integrazioni, card per le dashboard e temi creati dalla community, che non fanno parte di Home Assistant.

Non è un progetto ufficiale: installa codice di terze parti con gli stessi permessi di Home Assistant. Questa guida lo installa seguendo la procedura ufficiale, lo collega a GitHub e scarica un primo componente controllandone l'affidabilità.

Cosa ti serve per continuare

• Un account GitHub gratuito: serve solo ad autorizzare HACS a leggere i repository pubblici.
• Home Assistant aggiornato a una versione recente: HACS non supporta le versioni troppo vecchie.
• Accesso come amministratore. Su Home Assistant OS l'installazione passa da un'app; su Container serve un terminale sul computer che esegue Docker.

Se l'obiettivo finale è un pannello a muro con card personalizzate, un tablet come il Lenovo Tab 10,1 pollici FHD, 4 GB RAM, 128 GB, Wi-Fi 6 mostra senza problemi le dashboard con le card scaricate da HACS.

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

Fase 1: Scarica HACS

La procedura dipende dal tipo di installazione. Al termine i file di HACS si trovano nella cartella custom_components/hacs della configurazione.

Su Home Assistant OS

1. Apri Impostazioni → Applicazioni e premi Installa app in basso a destra: si apre la Raccolta delle app.
2. Premi il menu a tre puntini in alto a destra, scegli Archivi digitali, incolla https://github.com/hacs/addons nel campo e premi Aggiungi, poi chiudi la finestra.
3. Ricarica la pagina, cerca l'app Get HACS, aprila e premi Installa. A installazione finita premi Avvia.
4. Apri la scheda Registro dell'app e attendi il messaggio che chiede di riavviare Home Assistant. L'app ha finito il suo compito e può restare ferma.
5. Riavvia da Impostazioni → menu a tre puntini in alto a destra → Riavvia Home Assistant → Riavvia Home Assistant.

Su Home Assistant Container

1. Sul computer che esegue Docker apri un terminale ed entra nel container con docker exec -it homeassistant bash (sostituisci homeassistant con il nome del tuo container).
2. Lancia lo script ufficiale wget -O - https://get.hacs.xyz | bash - e attendi il messaggio di completamento.
3. Esci con exit e riavvia il container, per esempio con docker restart homeassistant.

Fase 2: Aggiungi l'integrazione e autorizza GitHub

Dopo il riavvio HACS si aggiunge come una normale integrazione, con un'autorizzazione una tantum dal tuo account GitHub.

1. Ricarica la pagina del browser forzando l'aggiornamento (Ctrl+F5 su Windows, Cmd+Shift+R su Mac), poi apri Impostazioni → Dispositivi e servizi e premi Aggiungi integrazione.
2. Cerca HACS, seleziona tutte le caselle di presa visione e premi Invia: compare un codice di 8 caratteri.
3. Apri https://github.com/login/device in un'altra scheda, accedi a GitHub, incolla il codice, premi Continue e poi Authorize HACS.
4. Torna alla scheda di Home Assistant: alla conferma premi Finito. La voce HACS compare nella barra laterale.

Fase 3: Scarica il primo componente

HACS mostra un unico elenco con ricerca e filtri, senza più schede separate per integrazioni e card.

1. Apri HACS dalla barra laterale e scrivi il nome del componente nel campo di ricerca. Con il pulsante dei filtri puoi limitare il Tipo a integrazioni, dashboard (card) o temi.
2. Apri il repository, leggi la descrizione e premi Download in basso a destra; conferma la versione proposta.
3. Per un'integrazione: riavvia Home Assistant quando richiesto, poi aggiungila da Impostazioni → Dispositivi e servizi → Aggiungi integrazione.
4. Per una card: ricarica la pagina forzando l'aggiornamento; la card compare tra quelle disponibili nell'editor delle dashboard.

Se un progetto non compare nella ricerca, puoi aggiungerlo dal menu a tre puntini di HACS → Custom repositories, incollando l'indirizzo GitHub e scegliendo il tipo corretto.

Verifica e test operativo

• In HACS usa il filtro di stato per mostrare solo i componenti scaricati e controlla che ci sia quello appena aggiunto.
• Apri Impostazioni → Sistema → Registri e cerca il nome del componente.

Cosa fare se qualcosa non funziona

Requisiti e risorse ufficiali

• HACS: prerequisiti ufficiali
• HACS: procedura ufficiale di download
• HACS: configurazione dell'integrazione
• Se Home Assistant non si avvia: diagnosi e ripristino

Verifica su Home Assistant 2026.9 e sulla documentazione HACS: 2 ottobre 2026.