Come installare HACS su Home Assistant: guida completa 2026 (HACS 2.0)

Cos’è HACS e perché installarlo

Se stai usando Home Assistant e vuoi espandere le sue funzionalità oltre quelle standard, HACS (Home Assistant Community Store) è probabilmente la prima cosa che dovresti installare. Questo potente strumento ti permette di accedere a migliaia di componenti personalizzati sviluppati dalla community, trasformando la tua installazione di Home Assistant in una piattaforma ancora più versatile e personalizzabile.

HACS rappresenta il ponte tra Home Assistant e l’enorme ecosistema di sviluppatori della community. Attraverso questa piattaforma puoi installare integrazioni per dispositivi non ancora supportati ufficialmente, applicare temi personalizzati per cambiare completamente l’aspetto della tua interfaccia, e aggiungere card per dashboard avanzate per creare interfacce davvero uniche.

Requisiti prima dell’installazione di HACS

Prima di iniziare il processo di installazione, devi assicurarti di avere alcuni elementi fondamentali.

Requisiti di sistema

• Home Assistant versione 2024.4.1 o superiore (questo è il requisito minimo aggiornato per HACS 2.0)
• Account GitHub gratuito per l’autenticazione
• Accesso completo al file system della tua installazione Home Assistant

Tipi di installazione supportati

Questo metodo funziona perfettamente con:

• Home Assistant OS
• Home Assistant Supervised
• Home Assistant Container
• Home Assistant Core

Per chi parte da zero, trovi una guida dettagliata all’installazione su Raspberry Pi con boot da SSD per prestazioni ottimali.

Metodo 1: Installazione via Addon (Home Assistant OS/Supervised)

Se stai utilizzando Home Assistant Operating System o Supervised, hai a disposizione il metodo più semplice per installare HACS attraverso un addon dedicato. Questo approccio elimina la necessità di dover accedere manualmente ai file del sistema.

Passo 1: Aggiunta del repository personalizzato

Il primo passo consiste nell’aggiungere il repository che contiene l’addon HACS. Questo repository non è incluso di default in Home Assistant, quindi dovrai aggiungerlo manualmente.

Come aggiungere il repository HACS:

1. Utilizza questo link diretto per aggiungere il repository dell’addon HACS alla tua installazione Home Assistant
2. Quando richiesto di confermare se vuoi aprire la pagina in Home Assistant, verifica che l’URL sia corretto
3. Seleziona Apri link
4. Nella finestra di dialogo Repository addon mancante, seleziona Aggiungi
5. Hai ora aggiunto il repository che ti permette di scaricare HACS su Home Assistant

Passo 2: Installazione dell’addon

1. Nell’addon Get HACS, seleziona Installa
2. Il processo di download e installazione inizierà automaticamente
3. Attendi il completamento dell’installazione

Passo 3: Avvio dell’addon

1. Una volta completata l’installazione, fai clic su Avvia per eseguire l’addon
2. Naviga verso i log dell’addon e segui attentamente le istruzioni fornite
3. Questi log conterranno informazioni specifiche per completare l’installazione

Passo 4: Passaggi finali

Per completare l’installazione di HACS, sono necessari alcuni passaggi finali:

1. Riavvia Home Assistant: è essenziale riavviare completamente Home Assistant per permettere a HACS di integrarsi correttamente nel sistema
2. Configurazione dell’integrazione HACS: segui i passaggi per configurare e attivare l’integrazione HACS nella sezione Integrazioni di Home Assistant

Metodo 2: Installazione via SSH e Terminale

Un modo alternativo per installare HACS nel 2026 è utilizzare lo script di installazione automatica. Questo metodo elimina la possibilità di errori manuali e garantisce che tutti i file vengano posizionati correttamente. È l’unico metodo disponibile per Home Assistant Core.

Passo 1: Accesso al terminale

Accedi al terminale di Home Assistant o utilizza l’add-on Terminal & SSH se stai usando Home Assistant OS.

Passo 2: Esecuzione dello script di installazione

Una volta nel terminale, esegui uno dei seguenti comandi.

Con wget (metodo preferito):

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

Con curl (alternativa):

curl -sfSL https://get.hacs.xyz | bash -

Passo 3: Verifica dell’installazione

Lo script scaricherà automaticamente tutti i file necessari e li posizionerà nella cartella corretta. Durante questo processo vedrai vari messaggi di conferma che ti indicheranno lo stato dell’installazione.

Passo 4: Riavvio di Home Assistant

Una volta completato lo script, dovrai riavviare Home Assistant:

1. Vai nelle impostazioni di sistema attraverso l’interfaccia web
2. Seleziona Sistema > Hardware
3. Clicca su Riavvia host (angolo in alto a destra)

Passo 5: Aggiunta dell’integrazione

Dopo il riavvio, HACS non sarà ancora visibile nella tua interfaccia. Dovrai aggiungere manualmente l’integrazione:

1. Vai in Impostazioni > Dispositivi e servizi
2. Clicca su Aggiungi integrazione (pulsante in basso a destra)
3. Cerca HACS nell’elenco
4. Selezionalo per completare l’installazione

Configurazione iniziale e autenticazione GitHub

Dopo aver completato l’installazione con uno dei metodi sopra indicati, è necessario configurare HACS e autenticarsi con GitHub.

Passo 1: Aggiunta dell’integrazione HACS

1. Vai in Impostazioni > Dispositivi e servizi
2. Clicca su Aggiungi integrazione
3. Cerca HACS e selezionalo

Passo 2: Autenticazione con GitHub

La prima volta che accedi a HACS dopo l’installazione, ti verrà richiesto di completare la configurazione iniziale. Questo processo include l’autenticazione con GitHub, che è necessaria per accedere ai repository dei componenti personalizzati.

Il processo di autenticazione:

1. HACS genererà un codice di attivazione univoco di 8 cifre
2. Il sistema ti fornirà un link diretto (https://github.com/login/device)
3. Clicca sul link per essere portato alla pagina di attivazione GitHub
4. Effettua l’accesso al tuo account GitHub (se non lo hai già fatto)
5. Inserisci il codice di 8 cifre
6. Autorizza HACS ad accedere alle informazioni pubbliche del tuo profilo

Passo 3: Configurazione area (novità HACS 2.0)

Durante la configurazione iniziale dovrai anche assegnare HACS a un’area della tua casa. Questa è una nuova funzionalità di HACS 2.0 per una migliore organizzazione delle tue integrazioni.

Passo 4: Accettazione dei termini

Dovrai accettare i termini e condizioni di HACS. È importante leggere attentamente questo documento perché spiega che:

• I componenti installati tramite HACS sono sviluppati da terze parti
• Non sono ufficialmente supportati dal team di Home Assistant
• L’installazione avviene a tuo rischio

Novità di HACS 2.0 (Agosto 2024)

HACS ha ricevuto il suo aggiornamento più importante con la versione 2.0, rilasciata nell’agosto 2024. Ecco le principali novità che troverai.

Interfaccia completamente ridisegnata

L’interfaccia di HACS ora rispecchia perfettamente lo stile nativo di Home Assistant, con tabelle dati che includono le stesse funzionalità che trovi nelle pagine delle entità o delle automazioni:

• Filtri avanzati: filtra i componenti per tipo, categoria, stato
• Raggruppamento intelligente: raggruppa i componenti secondo le tue preferenze
• Ordinamento flessibile: ordina per nome, data di aggiornamento, popolarità
• Ricerca potente: trova rapidamente ciò che cerchi con la ricerca integrata

Notifiche di aggiornamento native

Una delle novità più apprezzate: gli aggiornamenti dei componenti HACS appaiono ora nella sezione Impostazioni > Aggiornamenti insieme agli aggiornamenti di sistema, add-on e integrazioni.

Vantaggi:

• Non è più necessario visitare la pagina HACS ogni giorno per verificare gli aggiornamenti
• Notifiche unificate nel formato nativo di Home Assistant
• Dopo ogni aggiornamento, ricevi suggerimenti automatici per azioni necessarie (riavvio, ricaricamento dashboard, ecc.)
• Sistema di riparazioni integrato che ti guida passo dopo passo

Download ultra-veloci

HACS 2.0 utilizza un nuovo sistema di metadati ospitato su Cloudflare R2 che:

• Riduce drasticamente le chiamate API a GitHub
• Accelera enormemente il processo di download
• Migliora i tempi di installazione dei componenti
• Garantisce maggiore stabilità durante le operazioni

Modifiche importanti da conoscere

HACS 2.0 introduce alcune modifiche significative:

• Non è più possibile configurare HACS tramite YAML
• La piattaforma sensor è stata rimossa
• Le app NetDaemon non sono più disponibili in HACS
• I file info.md non vengono più renderizzati (viene utilizzato il README)
• L’endpoint /hacsfiles/ non funziona più per i temi
• La selezione beta è ora gestita tramite un’entità switch (più semplice da usare)

Se dopo l’aggiornamento cerchi custom card per Home Assistant, la nuova interfaccia HACS 2.0 rende più semplice trovare e installare quelle della community.

Come aggiornare HACS

Con HACS 2.0, aggiornare HACS stesso è diventato molto più semplice rispetto al passato, grazie all’integrazione nativa con il sistema di aggiornamenti di Home Assistant.

Aggiornamento tramite Impostazioni > Aggiornamenti

Quando è disponibile una nuova versione di HACS, la notifica appare direttamente in Impostazioni > Aggiornamenti, nella stessa schermata in cui trovi gli aggiornamenti di Home Assistant, degli add-on e delle integrazioni.

1. Vai in Impostazioni > Aggiornamenti
2. Individua l’aggiornamento HACS nell’elenco
3. Clicca su Installa
4. Al termine, segui i suggerimenti automatici: in genere è sufficiente ricaricare la dashboard, senza riavviare Home Assistant

Aggiornamento dei componenti installati tramite HACS

Lo stesso meccanismo vale per i componenti che hai installato tramite HACS. Quando uno sviluppatore rilascia una nuova versione, la notifica compare in Impostazioni > Aggiornamenti. Dopo l’aggiornamento, HACS indica automaticamente l’azione consigliata (riavvio, ricaricamento integrazione, ecc.).

Come utilizzare HACS per installare componenti

Una volta completata la configurazione, HACS apparirà nella barra laterale di Home Assistant con una nuova interfaccia completamente ridisegnata.

L’interfaccia di HACS 2.0

L’interfaccia presenta ora tabelle dati simili a quelle che trovi nelle pagine delle entità o delle automazioni, con:

• Barra di ricerca potente in alto per trovare rapidamente i componenti
• Filtri avanzati per tipo, categoria, stato di aggiornamento
• Colonne personalizzabili per visualizzare le informazioni che ti interessano
• Informazioni dettagliate su ogni componente con un solo clic

Ricerca e scoperta di componenti

Puoi trovare nuovi componenti in diversi modi:

• Ricerca per nome: inserisci il nome del componente nella barra di ricerca
• Navigazione per tipo: esplora le diverse categorie (Integrazioni, Dashboard, Temi, Template)
• Filtro per stato: visualizza solo componenti con aggiornamenti disponibili
• Ordinamento: ordina per popolarità (stelle GitHub), ultima attività, nome alfabetico

Installare un componente

Il processo di installazione è semplice e intuitivo:

1. Trova il componente che ti interessa usando la ricerca o i filtri
2. Clicca sul componente per aprire la pagina dei dettagli
3. Leggi le informazioni: descrizione dettagliata, link al repository GitHub, numero di stelle e popolarità, data dell’ultimo aggiornamento e versioni disponibili
4. Clicca su “Scarica” (o “Download”)
5. Seleziona la versione (se disponibili più versioni)
6. Conferma il download

Notifiche di aggiornamento (novità HACS 2.0)

Con HACS 2.0, la gestione degli aggiornamenti è completamente integrata:

• Gli aggiornamenti appaiono in Impostazioni > Aggiornamenti
• Visualizzi le note di rilascio direttamente nella notifica
• Clicchi su Installa per aggiornare
• HACS fornisce suggerimenti automatici dopo l’aggiornamento: “Riavvia Home Assistant”, “Ricarica le dashboard”, “Ricarica l’integrazione”

Componenti HACS popolari da provare (2026)

HACS offre accesso a centinaia di componenti personalizzati. Ecco alcuni dei più popolari e utili da considerare.

Integrazioni essenziali

Alarmo - Sistema di allarme completo

Crea un sistema di allarme professionale usando i tuoi sensori esistenti. Gestione completa via interfaccia utente senza YAML, supporta 4 modalità di armamento personalizzabili. Ideale per chi vuole un sistema di sicurezza senza hardware aggiuntivo.

PowerCalc - Calcolo consumi energetici

Stima il consumo energetico di dispositivi senza sensori di potenza. Strategie intelligenti basate sullo stato del dispositivo, integrazione perfetta con l’Energy Dashboard. Essenziale per monitorare i consumi reali della casa.

Local Tuya - Controllo locale dispositivi Tuya

Controlla dispositivi Tuya Wi-Fi senza cloud. Maggiore privacy e minor latenza, supporta prese, luci, interruttori e sensori. Funziona anche senza connessione internet.

Adaptive Lighting - Illuminazione circadiana

Regola automaticamente luminosità e colore delle luci seguendo il ciclo del sole per un ritmo circadiano naturale. Migliora la qualità del sonno con configurazione per stanza o gruppo di luci.

Dashboard e Frontend

Mushroom Cards - Collezione di card minimaliste

Design pulito e moderno con card per ogni tipo di entità. Perfette per dashboard mobile e facili da configurare.

Bubble Card - Card interattive moderne

Interfaccia ottimizzata per mobile con pop-up, slider e media player avanzati. Design accattivante e funzionale con aggiornamenti regolari.

Weather Card (Animated) - Meteo con animazioni

Icone SVG animate di amCharts con più opzioni del weather card nativo. Previsioni dettagliate, ottimo per dashboard a parete.

Utility e strumenti

Battery Notes - Gestione batterie

Traccia il tipo di batteria per ogni dispositivo con promemoria per sostituzione batterie. Integrazione con sistema di notifiche e database di batterie comuni.

ZHA Toolkit - Operazioni Zigbee avanzate

Binding e unbinding tra dispositivi, configurazione reporting personalizzato, backup e restore rete Zigbee. Per utenti avanzati.

Massimizzare il potenziale di HACS

HACS trasforma completamente l’esperienza con Home Assistant, ma per sfruttarne appieno il potenziale è importante esplorare gradualmente le diverse categorie di componenti disponibili.

Integrazioni per dispositivi

Inizia con le integrazioni per i dispositivi che possiedi e che non sono ancora supportati ufficialmente da Home Assistant. Categorie comuni:

• Climatizzatori e pompe di calore: molti brand asiatici trovano supporto solo in HACS
• Elettrodomestici smart: lavatrici, asciugatrici, robot aspirapolvere di brand minori
• Dispositivi Tuya/Smart Life: controllo locale senza cloud
• Veicoli elettrici: integrazioni per Tesla, BMW, Audi, Volkswagen

Temi personalizzati

I temi possono dare un aspetto completamente nuovo alla tua interfaccia Home Assistant. Tipologie disponibili:

• Temi scuri: per ridurre l’affaticamento degli occhi, specialmente di notte
• Temi colorati: per un’interfaccia più vivace e personalizzata
• Temi minimalisti: per un aspetto pulito e professionale
• Temi brand: ispirati a Material Design, iOS, Windows, ecc.

Una volta installato un tema da HACS, puoi anche impostare un tema personalizzato per ogni utente della famiglia, così ognuno vede l’interfaccia che preferisce.

Strategia di adozione

Non installare tutto subito. Segui questo approccio:

Domande frequenti su HACS

HACS è sicuro da installare?

Sì. HACS in sé è un progetto open source supportato dall’Open Home Foundation. I componenti che installi tramite HACS però sono sviluppati da terze parti e non verificati dal team ufficiale di Home Assistant. Usa sempre componenti da sviluppatori con buona reputazione e controlla il numero di stelle e l’attività del repository GitHub prima di installarli.

Ho bisogno di un account GitHub per usare HACS?

Sì, un account GitHub gratuito è necessario. HACS richiede l’autenticazione GitHub per evitare i limiti delle API pubbliche durante la ricerca e il download dei componenti. L’autenticazione è sicura: HACS non può accedere ai tuoi repository privati né modificare il tuo account.

HACS funziona con tutte le versioni di Home Assistant?

HACS 2.0 richiede Home Assistant 2024.4.1 o superiore. Se hai una versione precedente, aggiorna prima Home Assistant e poi installa HACS.

Cosa succede ai componenti HACS dopo un aggiornamento di Home Assistant?

In genere i componenti rimangono funzionanti. Con HACS 2.0, gli aggiornamenti dei componenti appaiono direttamente in Impostazioni > Aggiornamenti insieme agli aggiornamenti di sistema. Se un componente diventa incompatibile, HACS lo segnala con il sistema di riparazioni integrato.

Posso installare HACS su Home Assistant Core senza OS?

Sì, puoi usare il metodo SSH/terminale descritto in questa guida. Il metodo via Addon è disponibile solo per Home Assistant OS e Supervised.

Conclusione

L’installazione di HACS rappresenta uno dei primi passi fondamentali per chiunque voglia sfruttare appieno le potenzialità di Home Assistant. Con l’arrivo di HACS 2.0 nell’agosto 2024, questo strumento è diventato ancora più potente, intuitivo e integrato con l’ecosistema Home Assistant.

Cosa rende HACS indispensabile nel 2026

Inizia il tuo viaggio con HACS

Seguendo questa guida aggiornata per il 2026, dovresti essere in grado di installare e configurare HACS senza difficoltà, aprendo così le porte a un mondo di personalizzazioni e integrazioni avanzate. Per la documentazione ufficiale e gli aggiornamenti del progetto, consulta hacs.xyz.