Home assistantIntegrazioni

Installare HACS su Home Assistant: dal vecchio HACS al Marketplace integrato

Foto di Massimo Di Vona

Massimo Di Vona

26 maggio 2025 • Aggiornato il 11 novembre 2026

Installare HACS su Home Assistant: il Marketplace integrato da Home Assistant 2026.11

Da Home Assistant 2026.11 HACS non si installa più a parte: è stato integrato (finalmente) in modo nativo nel sistema e si chiama Marketplace. Per i repository e i componenti personalizzati che avevi non cambia nulla: restano installati e continuano ad aggiornarsi. Se avevi già HACS, vai direttamente al capitolo 8: cosa succede se avevi già HACS.

Sul mio Raspberry Pi 5 ho installato solo quello che ritengo davvero utile — Alexa Media Player per l’Echo Plus, card-mod, la nostra integrazione WeSmart Garbage e le mie WeSmart Cards, ancora in fase di test — ma la lista di quello che prima HACS e ora il Marketplace mette a disposizione è enorme. Rende Home Assistant migliore: ci sono integrazioni fatte molto bene, che sopperiscono alla mancanza di quelle ufficiali. Mi vengono in mente la storica Button Card, le integrazioni meteo, iCloud.

Cos’è il Marketplace e cosa cambia rispetto a HACS

HACS è nato come strumento di affiancamento a Home Assistant, ma nel tempo è diventato qualcosa di indispensabile: ha dato all’intera community la possibilità di distribuire le proprie card e integrazioni direttamente sul sistema di chiunque. Lo abbiamo fatto anche noi con l’integrazione WeSmart Garbage e la sua card per la raccolta differenziata, che oggi trovi nel catalogo del Marketplace.

HACS e Open Home Foundation

ludeeus ha creato HACS e, circa un anno e mezzo fa, l’ha donato alla Open Home Foundation. Ora il passo successivo: la trasformazione in Marketplace, integrato direttamente nel sistema. Quella arrivata con Home Assistant 2026.11 è la prima versione, a cui ne seguiranno altre.

Secondo me è stata un’evoluzione scontata e necessaria: un progetto ben fatto che diventa parte del sistema. Bene anche il cambio di nome da HACS a Marketplace, anche se fa pensare a un mercato a pagamento (staremo a vedere: per ora le note di rilascio dicono che tutto quello che c’è nel Marketplace è gratuito e che resterà così).

Al primo avvio compare un avviso ufficiale che ci ricorda la natura del Marketplace:

“Everything in the Marketplace is made and published by the community, not by the Home Assistant project. Marketplace content runs in Home Assistant. It can access your home, your data, and the system that runs Home Assistant.”

Tutto quello che c’è nel Marketplace è creato e pubblicato dalla community, non dal progetto Home Assistant. Gira dentro Home Assistant e può accedere alla tua casa, ai tuoi dati e al sistema su cui gira Home Assistant. — documentazione del Marketplace

In pratica niente di quello che è pubblicato è testato dal progetto Home Assistant: bisogna fare sempre attenzione alla propria privacy e all’accesso ai dati, e alcuni componenti fatti male possono peggiorare le prestazioni.

Solo la prima volta ci viene chiesto quindi di accettare condizioni e rischi, spuntando I understand the risks and agree (Ho capito i rischi e accetto). Finché non lo facciamo possiamo sfogliare il catalogo, ma non installare né aggiornare nulla.

Quale versione di Home Assistant hai

Una piccola tabella riassuntiva con i principali cambiamenti, a seconda che tu abbia una versione di Home Assistant precedente a quella di novembre 2026 oppure successiva.

Da installare

2026.11 e successiveNiente, è già in Settings (Impostazioni)
2026.10 e precedentiHACS separato

Come si installa

2026.11 e successiveNon si installa
2026.10 e precedentiApp “Get HACS” su OS e Supervised; script da terminale su Container e Core

Account GitHub

2026.11 e successiveNon serve per il catalogo; serve per Add from link (Aggiungi da link)
2026.10 e precedentiObbligatorio

Per il catalogo ufficiale non serve più un account GitHub; chi invece vuole aggiungere repository da link ne ha ancora bisogno, come indica la documentazione ufficiale. L’ho verificato di persona: trovi la prova nel capitolo sui repository personalizzati.

Supervised e Core, tra l’altro, sono deprecati dal 2025: ne ho parlato in Home Assistant dice addio a 32 bit e Core.

Dove si trova il Marketplace

Il Marketplace adesso si trova in Settings (Impostazioni) → Marketplace, tra Apps (App) e Dashboards (Plance). Alla prima apertura spuntiamo la casella dell’avviso e andiamo avanti.

Ci sono tre schede: Discover (Scopri), Browse (Sfoglia) e Installed (Installati). È già tutto pronto: basta cercare il componente personalizzato che vogliamo e installarlo. Niente codici GitHub per il catalogo e niente più le quattro caselle di consenso di HACS.

Installare un’integrazione o una card dal Marketplace

Installare un componente è molto semplice. Basta andare in Browse (Sfoglia), cercare il componente — per esempio WeSmart Garbage —, aprire la scheda e premere Install (Installa). La scheda mostra anche la versione disponibile e la versione minima di Home Assistant richiesta.

Nel mio caso WeSmart Garbage ha chiesto un riavvio del sistema: non si configura dall’interfaccia, quindi Home Assistant la carica solo dopo il riavvio. È il comportamento previsto dalla documentazione per questo tipo di integrazioni. Per altri componenti che ho provato, come Powercalc, invece il riavvio non è servito.

Le card si attivano ricaricando il browser; temi e template si caricano da soli.

Dove installa i file il Marketplace

Ogni tipo di contenuto finisce in una cartella precisa dentro la configurazione di Home Assistant (/config).

Integrazione

Cartellacustom_components
Cosa fa in piùPoi la configuri in Devices & services (Dispositivi e servizi)

Card o elemento della plancia

Cartellawww/community
Cosa fa in piùLa registra da solo come risorsa della plancia

Tema

Cartellathemes
Cosa fa in piùServe la riga dei temi in configuration.yaml

Template

Cartellacustom_templates
Cosa fa in piùLe macro si importano nei template

La cartella custom_templates compare solo dopo aver installato il primo template: per questo nel mio screenshot non c’è.

Gestisci le risorse della plancia in YAML?

Se le risorse sono dichiarate in configuration.yaml, il Marketplace non può aggiungerle da solo: la finestra di installazione ti mostra la riga da inserire a mano, con questa forma.

YAMLRisorsa della plancia in configuration.yaml
lovelace:
  resources:
    - url: /local/community/<nome-repository>/<file>.js
      type: module

Lo stesso vale per i temi: se nel tuo configuration.yaml manca la riga dei temi, aggiungila.

YAMLTemi in configuration.yaml
frontend:
  themes: !include_dir_merge_named themes

Nota: nello screenshot vedi anche www/community/wesmart-cards. Le WeSmart Cards non vengono dal Marketplace: sono un progetto nuovo, ancora in test, e le ho copiate a mano. Il Marketplace non le gestisce, quindi non le aggiorna.

Per un repository personalizzato si può aggiungere un componente con il pulsante Add from link (Aggiungi da link): così possiamo installare componenti che non sono nel catalogo ufficiale del Marketplace.

In questo caso bisogna connettersi e autenticarsi con GitHub. Per chi aveva già HACS non cambia niente, perché il collegamento passa al Marketplace in automatico; per i nuovi utenti sarà Home Assistant a chiederlo e a guidare. Ovviamente i repository aggiunti devono essere pubblici e rispettare i requisiti del Marketplace, come la presenza del file hacs.json (ma questa è una cosa che riguarda chi crea un componente).

L’ho testato. Ho revocato su GitHub l’autorizzazione delle vecchie credenziali HACS e ho provato ad aggiungere da link un repository personalizzato: Home Assistant mi ha segnalato una riparazione, Authentication expired (Autenticazione scaduta), e mi ha chiesto di riautenticarmi con questi passaggi.

Durante la prova ho scoperto anche un’altra cosa: revocare l’autorizzazione su GitHub scollega tutte le istanze di Home Assistant in un colpo solo, compresa quella nuova che usavo per i test.

Aggiornare e disinstallare

Ogni progetto installato ha un’entità di aggiornamento. Il Marketplace controlla il catalogo ogni 6 ore e, quando c’è una nuova versione, la trovi in Settings → Updates (Impostazioni → Aggiornamenti), accanto agli aggiornamenti di Home Assistant. Gli aggiornamenti non si installano da soli: li confermi tu, oppure li affidi a un’automazione. Dopo l’aggiornamento di un’integrazione serve un riavvio, e una riparazione te lo ricorda.

Come prima, si può disinstallare un componente dai tre puntini nella lista dei progetti installati, premendo Uninstall (Disinstalla). Massima semplicità. Dallo stesso menu c’è anche Install another version (Installa un’altra versione), che però non serve per tornare indietro dopo un aggiornamento: in quel caso si ripristina un backup.

Avevi già HACS: cosa succede con 2026.11

Se avevi già HACS e hai aggiornato Home Assistant alla 2026.11 o successive, non devi fare assolutamente nulla. L’integrazione HACS viene rimossa automaticamente e al suo posto, in Settings (Impostazioni) → Marketplace, troviamo la nuova voce.

Le risorse passano da /hacsfiles/ a /local/community/. I vecchi percorsi continueranno a funzionare, e chi le gestisce in YAML riceverà una riparazione.

Altre cose da sapere:

  • i segnalibri a /hacs aprono il Marketplace;
  • il collegamento a GitHub resta, quindi la richiesta non ricompare;
  • le app AppDaemon e gli script Python non sono più gestiti: restano dove sono e funzionano, ma non ricevono aggiornamenti (una riparazione ti dice quali);
  • un repository personalizzato senza file hacs.json resta installato, ma non si aggiorna più.
Usi integration_entities(‘hacs’) nei template?

Quella ricerca non trova più nulla. Sostituiscila così:

JINJATemplate prima e dopo
{# Prima #}
{{ integration_entities('hacs') }}

{# Dopo #}
{{ integration_entities('marketplace') }}

Le entità di aggiornamento invece mantengono il loro ID, quindi automazioni e plance che le usano continuano a funzionare. Tutti i dettagli sono nella sezione Coming from HACS della documentazione.

Io non ho trovato nessun tipo di problema nel passaggio. Devo essere onesto e non parlare per tutti, perché le mie integrazioni sono poche, ma per quello che posso dire e confermare il passaggio è stato totalmente indolore e tutto funziona anche dopo.

Installare HACS su Home Assistant 2026.10 o precedenti

Dalla 2026.11 l’installer di HACS non funziona più e il vecchio HACS non riceve nuovi rilasci: il mio consiglio è aggiornare Home Assistant. Se per qualche motivo devi restare su una versione precedente, ecco come si installava.

Procedura per Home Assistant 2026.10 e precedenti
  • OS e Supervised: in Settings → Apps (Impostazioni → App) aggiungi il repository https://github.com/hacs/addons, installa l’app Get HACS, avviala e segui le istruzioni nei log.
  • Container: entra nel container con docker exec -it <nome-container> bash ed esegui wget -O - https://get.hacs.xyz | bash -.
  • Core: con l’utente che esegue Home Assistant, esegui lo stesso script.

In tutti i casi poi riavvii Home Assistant, aggiungi l’integrazione HACS e la colleghi a GitHub. Trovi la procedura completa nella documentazione di HACS.

I componenti del Marketplace che uso (e quelli che ho usato)

Questi sono i componenti che conosco direttamente: alcuni li uso ogni giorno, altri li ho usati in passato o li sto provando. Niente liste generiche.

Alexa Media Player — quando Alexa acquista i superpoteri

Da appassionato di domotica avevo acquistato l’Echo Plus con grandi aspettative, ma dopo un po’ mi sono ritrovato a usarlo quasi solo per accendere e spegnere le luci. L’integrazione con Home Assistant tramite Alexa Media Player ha cambiato tutto: ora faccio partire la musica quando premo un pulsante fisico, ricevo notifiche vocali alle ore stabilite e ho fatto dialogare tanti dispositivi che prima non comunicavano tra loro. Alexa con Home Assistant acquista davvero i superpoteri. Ne ho parlato nella guida ad Alexa e Home Assistant.

Echo Plus Gen2 nel mio setup: con Alexa Media Player gestisce automazioni, script e notifiche vocali.

Nota Marketplace: Alexa Media Player è nel catalogo, non serve aggiungerlo da link. Repository

Bubble Card

La custom card più popolare della community per popup, slider e media player avanzati. Sul mio setup era la base di tutte le dashboard mobile. Ho scritto una guida completa con esempi YAML se vuoi approfondire.

Ora l’ho sostituita, perché sto provando a usare le mie WeSmart Cards.

Nota Marketplace: Bubble Card è nel catalogo, tipo Dashboard. Repository

WeSmart Custom Cards — un progetto nato per necessità

Ero stufo delle card standard di Home Assistant: funzionali, ma graficamente piatte. Ho iniziato come sfida personale, volendo anche capire quanto l’AI potesse aiutare nello sviluppo di card e frontend per Home Assistant. Da lì è nato questo progetto: card dal design minimal, con caratteri puliti e colori sobri. Ne è un esempio la card per la raccolta differenziata, diversa dai soliti componenti ma molto funzionale. Il concetto che accomuna tutti i progetti è la semplicità.

Il progetto ha preso un’evoluzione: ora siamo in una fase molto preliminare della beta, e sto cercando di integrare tutte le card in un’unica card “tutto in uno”, sullo stile di Bubble Card. Trovi la guida all’installazione delle card attuali sul sito.

Nota Marketplace: le WeSmart Cards non sono ancora nel Marketplace. Sono in test e per ora si installano a mano, copiando i file nella configurazione e aggiungendo la risorsa della plancia. Repository

Adaptive Lighting — illuminazione che segue il sole

Regola automaticamente luminosità e temperatura colore delle luci seguendo il ciclo del sole. È un’integrazione che in passato ho provato con le Innr e le Yeelight del mio setup: gestisce il passaggio dalla luce fredda di giorno a quella calda la sera, senza nessuna automazione manuale da configurare. Molto utile per chi vuole questo tipo di automazione in casa.

Nota Marketplace: Adaptive Lighting è nel catalogo, tipo Integration. Repository

Powercalc e Lovelace Text Input Row

Powercalc e Lovelace Text Input Row li ho installati da poco e sono in fase di test: devo ancora capire se mi sono utili e se mi servono davvero. Powercalc in particolare sarà uno dei prossimi articoli.

Nota Marketplace: Powercalc è nel catalogo, tipo Integration. Repository

Conclusione

HACS, ora Marketplace, è uno di quei componenti che trasformano Home Assistant da sistema domotico potente a piattaforma davvero aperta. La community ha costruito sopra di esso un ecosistema che nessun produttore potrebbe replicare: integrazioni per dispositivi non supportati ufficialmente, card per plance che l’interfaccia nativa non offre, strumenti che rendono il sistema su misura per chi lo usa.

Non tutto quello che c’è nel Marketplace serve davvero, ma spesso ci troviamo cose che non esistono altrove. Per la documentazione ufficiale e gli aggiornamenti del progetto, consulta la pagina del Marketplace su home-assistant.io.

Foto di Massimo Di Vona

Massimo Di Vona

Esperto di Smart Home e domotica, fondatore di WeAreSmart.it.

Massimo si occupa di tendenze tecnologiche da oltre un decennio, con un'attenzione particolare alle automazioni domestiche e alla smart home, ambiti che ha approfondito in particolare con Home Assistant. Si interessa anche di intelligenza artificiale e delle sue applicazioni nella tecnologia consumer.

Home AssistantHACSMarketplaceSmart HomeDomoticaTutorial