Documentație

Instalare

Nucleum Hub e o integrare mică pentru Home Assistant. O instalezi o dată, pe Home Assistant, și apare în bara laterală a fiecărui ecran. E un singur pachet: dashboard-ul, pozele lui și integrarea vin împreună și nu copiezi niciodată un fișier de mână.

Înainte să începi

  • Home Assistant 2026.3 sau mai nou, pe orice tip de instalare: Home Assistant OS, Container, Core sau Supervised.
  • Un cont de administrator, pentru instalare și prima pornire.
  • HACS, dacă vrei varianta dintr-un clic. Fără el, folosești zip-ul.
  • Internet pentru Home Assistant când adaugi integrarea: pornește evaluarea de 60 de minute cu serverul nostru.
  • Browsere: Chrome / Edge 105+, Safari 16+, Firefox 121+. Nu știi sigur dacă merge pe tabletă? Deschide întâi demo-ul pe ea.

1. Adaugi depozitul nostru în HACS

Nucleum Hub nu e în lista implicită a HACS: adaugi depozitul nostru în HACS ca depozit custom, o singură dată.

  • Dintr-un clic: deschide Adaugă în HACS cu My Home Assistant. Se deschide Home Assistant-ul tău și cere HACS să adauge depozitul nostru; confirmi cu Adaugă.
  • De mână: în HACS, deschizi meniul ⋮ › Depozite personalizate, lipești https://github.com/iulianmara/nucleum-hub, alegi tipul Integrare și apeși Adaugă.

2. Descarci și repornești

  1. În HACS, deschizi Nucleum Hub și apeși Descarcă.
  2. Repornești Home Assistant: Setări › Sistem › Repornire.

3. Adaugi integrarea

Setări › Dispozitive și servicii › Adaugă integrarea › Nucleum Hub, apoi Trimite. Nucleum Hub apare în bara laterală, pe fiecare ecran conectat la Home Assistant-ul tău, și pornește evaluarea de 60 de minute: toate funcțiile, după ceas, o dată pe instalarea de Home Assistant.

4. Lipești cheia de licență

Ai cumpărat o licență? Cheia vine de la noi pe e-mail, imediat după plată.

  1. Deschizi Setări › Dispozitive și servicii › Nucleum Hub › Configurează.
  2. Lipești cheia și confirmi. Literele mari sau mici și spațiile nu contează.
  3. Integrarea o activează o dată online, apoi o verifică singură cu serverul nostru. Păstrează e-mailul: noi ținem doar o amprentă a cheii.

Casele fără internet, mutările și instalarea de test: Licență și activare.

Fără HACS: zip-ul

  1. Descarci zip-ul din ultima versiune a depozitului nostru de pe GitHub.
  2. Îl dezarhivezi în dosarul de configurare al Home Assistant, cel în care e configuration.yaml. Trebuie să obții custom_components/wall_dashboard/.
  3. Repornești Home Assistant, apoi urmezi pașii 3 și 4 de mai sus.

Pe Home Assistant OS deschizi acel dosar de pe calculator cu add-on-ul Samba share sau cu Studio Code Server. Pe Container și Core, e dosarul pe care l-ai montat sau setat ca config. Dosarul wall_dashboard poartă numele tehnic al integrării; în Home Assistant apare ca Nucleum Hub.

Deschizi Nucleum Hub din bara laterală

Deschizi Nucleum Hub din bara laterală, pe un cont de administrator. Asistentul de configurare are trei pași: limba și un nume pentru salut, paginile dorite și ce a găsit în casa ta (panouri, rețea, baterie, vreme, alarmă și altele), ca să corectezi. Apeși Creează dashboardul.

Configurația se salvează în Home Assistant, nu în browser: de aceea fiecare ecran arată la fel și backup-urile Home Assistant o includ.

După o actualizare, ecranele deja deschise arată butonul Versiune nouă: îl atingi și se încarcă versiunea nouă. Nu se reîncarcă niciodată singure.

Pe tableta de perete

  • Adresa: deschizi http://homeassistant.local:8123/nucleum-hub, cu adresa Home Assistant-ului tău în locul lui homeassistant.local:8123, și te conectezi o dată, cu „Ține-mă minte”.
  • Fully Kiosk Browser: pui aceeași adresă ca adresă de pornire.
  • Fără bara laterală a Home Assistant: pe tabletă, deschizi profilul (numele tău, jos în bara laterală) și pornești opțiunea care ascunde mereu bara laterală (în engleză „Always hide the sidebar”). Se aplică doar acelui browser; o oprești deschizând pe tabletă http://homeassistant.local:8123/profile.

Telefoanele cu aplicația Home Assistant și un dashboard al fiecărui ecran: Aplicația Companion și Fully Kiosk.

Dacă Home Assistant filtrează traficul de ieșire

Integrarea vorbește doar cu api.nucleumhub.com (licența și evaluarea); actualizările vin de pe GitHub, prin HACS. Ecranele nu vorbesc cu niciunul.

Instalarea manuală, ca variantă de avarie

Doar dacă integrarea nu poate porni sau dacă ți-o cere suportul nostru. Dashboard-ul e un singur fișier din pachet: custom_components/wall_dashboard/frontend/wall-dashboard.html.

  1. Îl copiezi, cu dosarul wall-dashboard-weather de lângă el, în dosarul www din dosarul de configurare. Dacă nu exista un dosar www, îl creezi și repornești Home Assistant.
  2. Setări › Tablouri de bord › Adaugă tablou de bord › Pagină web, cu adresa /local/wall-dashboard.html.

Își citește configurația din Home Assistant, deci ecranele arată la fel. Versiunile noi vin doar cu integrarea.