Area clienti
IT, Lingua: Italiano
Prova la demo
Prova la demo
Documentazione

Installazione

Nucleum Hub è una piccola integrazione di Home Assistant. Installala una volta, sul tuo Home Assistant, e compare nella barra laterale di ogni schermo. È un solo pacchetto: la plancia, le sue immagini e l’integrazione arrivano insieme, e non copi mai un file a mano.

Prima di iniziare

  • Home Assistant 2026.3 o più recente, su qualsiasi tipo di installazione: Home Assistant OS, Container, Core o Supervised.
  • Un account amministratore, per l’installazione e il primo avvio.
  • HACS, se vuoi il metodo con un clic. Senza HACS, usa lo zip.
  • Internet per Home Assistant quando aggiungi l’integrazione: avvia la tua prova di 60 minuti con il nostro server.
  • Browser: Chrome / Edge 105+, Safari 16+, Firefox 121+. Dubbi sul tuo tablet? Aprici prima la demo.

1. Aggiungi il nostro repository a HACS

Nucleum Hub non è nell’elenco predefinito di HACS: aggiungi il nostro repository a HACS come repository personalizzato, una volta sola.

  • Con un clic: apri Aggiungi a HACS con My Home Assistant. Apre il tuo Home Assistant e chiede a HACS di aggiungere il nostro repository; conferma con Aggiungi.
  • A mano: in HACS apri il menu ⋮ › Repository personalizzati, incolla https://github.com/iulianmara/nucleum-hub, scegli il tipo Integrazione e premi Aggiungi.

2. Scarica e riavvia

  1. In HACS apri Nucleum Hub e premi Scarica.
  2. Riavvia Home Assistant: Impostazioni › Sistema › Riavvia.

3. Aggiungi l’integrazione

Impostazioni › Dispositivi e servizi › Aggiungi integrazione › Nucleum Hub, poi Invia. Nucleum Hub compare nella barra laterale, su ogni schermo connesso al tuo Home Assistant, e parte la tua prova di 60 minuti d’orologio: tutte le funzioni, una volta per installazione di Home Assistant.

4. Incolla la tua chiave di licenza

Hai acquistato una licenza? La chiave ti arriva da noi via e-mail, subito dopo il pagamento.

  1. Apri Impostazioni › Dispositivi e servizi › Nucleum Hub › Configura.
  2. Incolla la chiave e conferma. Maiuscole, minuscole e spazi non contano.
  3. L’integrazione la attiva online una volta, poi la verifica da sola con il nostro server. Conserva l’e-mail: noi conserviamo solo un’impronta della chiave.

Case senza internet, spostamenti e installazione di prova: Licenza e attivazione.

Senza HACS: lo zip

  1. Scarica lo zip dall’ultima versione pubblicata nel nostro repository su GitHub.
  2. Estrailo nella cartella di configurazione del tuo Home Assistant, quella che contiene configuration.yaml. Devi ottenere custom_components/wall_dashboard/.
  3. Riavvia Home Assistant, poi segui i passi 3 e 4 qui sopra.

Su Home Assistant OS apri quella cartella dal computer con il componente aggiuntivo Samba share, o con Studio Code Server. Su Container e Core è la cartella che hai montato o impostato come config. La cartella wall_dashboard porta il nome tecnico dell’integrazione; in Home Assistant compare come Nucleum Hub.

Apri Nucleum Hub nella barra laterale

Apri Nucleum Hub dalla barra laterale, con un account amministratore. L’assistente di configurazione ha tre passi: la tua lingua e un nome per il saluto, le pagine che vuoi e ciò che ha trovato in casa tua (solare, rete, batteria, meteo, allarme e altro), che puoi correggere. Premi Crea plancia.

La configurazione viene salvata in Home Assistant, non nel browser: per questo ogni schermo mostra la stessa cosa, e per questo i backup di Home Assistant la includono.

Dopo un aggiornamento, gli schermi già aperti mostrano un pulsante Nuova versione: toccalo per caricare la nuova versione. Non si ricaricano mai da soli.

Su un tablet a parete

  • L’indirizzo: apri http://homeassistant.local:8123/nucleum-hub, con l’indirizzo del tuo Home Assistant al posto di homeassistant.local:8123, e accedi una volta, con «Mantieni l’accesso».
  • Fully Kiosk Browser: usa lo stesso indirizzo come URL di avvio.
  • Senza la barra laterale di Home Assistant: sul tablet apri il tuo profilo (il tuo nome, in fondo alla barra laterale) e attiva l’opzione che nasconde sempre la barra laterale (in inglese «Always hide the sidebar»). Vale solo per quel browser; per disattivarla apri http://homeassistant.local:8123/profile sul tablet.

I telefoni con l’app di Home Assistant, e una plancia propria per ogni schermo: L’app Companion e Fully Kiosk.

Se il tuo Home Assistant filtra il traffico in uscita

L’integrazione parla solo con api.nucleumhub.com (licenza e prova); gli aggiornamenti arrivano da GitHub, tramite HACS. I tuoi schermi non parlano con nessuno dei due.

Installazione manuale, come ripiego

Solo se l’integrazione non può funzionare, o se la nostra assistenza te lo chiede. La plancia è un solo file del pacchetto: custom_components/wall_dashboard/frontend/wall-dashboard.html.

  1. Copialo, con la cartella wall-dashboard-weather che gli sta accanto, nella cartella www della tua cartella di configurazione. Se la cartella www non c’era, creala e riavvia Home Assistant.
  2. Impostazioni › Plance › Aggiungi plancia › Pagina web, con l’indirizzo /local/wall-dashboard.html.

Legge la configurazione da Home Assistant, quindi i tuoi schermi restano uguali. Le nuove versioni arrivano solo con l’integrazione.