Dokumentacja

Instalacja

Nucleum Hub to niewielka integracja Home Assistant. Instalujesz ją raz, w swoim Home Assistant, i pojawia się na pasku bocznym każdego ekranu. To jeden pakiet: panel, jego obrazy i integracja przychodzą razem i nigdy nie kopiujesz pliku ręcznie.

Zanim zaczniesz

  • Home Assistant 2026.3 lub nowszy, w dowolnym typie instalacji: Home Assistant OS, Container, Core lub Supervised.
  • Konto administratora, do instalacji i pierwszego uruchomienia.
  • HACS, jeśli chcesz instalacji jednym kliknięciem. Bez niego użyj pliku zip.
  • Internet dla Home Assistant przy dodawaniu integracji: rozpoczyna ona Twój 60-minutowy okres próbny z naszym serwerem.
  • Przeglądarki: Chrome / Edge 105+, Safari 16+, Firefox 121+. Nie masz pewności co do swojego tabletu? Najpierw otwórz na nim demo.

1. Dodaj nasze repozytorium do HACS

Nucleum Hub nie jest na domyślnej liście HACS: nasze repozytorium dodajesz do HACS jako repozytorium niestandardowe, jeden raz.

  • Jednym kliknięciem: otwórz Dodaj do HACS przez My Home Assistant. Otworzy się Twój Home Assistant i poprosi HACS o dodanie naszego repozytorium; potwierdź przyciskiem Dodaj.
  • Ręcznie: w HACS otwórz menu ⋮ › Niestandardowe repozytoria, wklej https://github.com/iulianmara/nucleum-hub, wybierz typ Integracja i naciśnij Dodaj.

2. Pobierz i uruchom ponownie

  1. W HACS otwórz Nucleum Hub i naciśnij Pobierz.
  2. Uruchom ponownie Home Assistant: Ustawienia › System › Uruchom ponownie.

3. Dodaj integrację

Ustawienia › Urządzenia oraz usługi › Dodaj integrację › Nucleum Hub, a potem Zatwierdź. Nucleum Hub pojawia się na pasku bocznym, na każdym ekranie zalogowanym do Twojego Home Assistant, i zaczyna się Twój 60-minutowy okres próbny: wszystkie funkcje, czas liczony według zegara, raz na instalację Home Assistant.

4. Wklej klucz licencyjny

Masz już licencję? Klucz wysyłamy Ci e-mailem zaraz po płatności.

  1. Otwórz Ustawienia › Urządzenia oraz usługi › Nucleum Hub › Konfiguruj.
  2. Wklej klucz i potwierdź. Wielkie czy małe litery i spacje nie mają znaczenia.
  3. Integracja raz aktywuje go online, a potem sama sprawdza go z naszym serwerem. Zachowaj ten e-mail: my przechowujemy tylko odcisk klucza.

Domy bez internetu, przeniesienia i instalacja testowa: Licencja i aktywacja.

Bez HACS: plik zip

  1. Pobierz plik zip z najnowszego wydania naszego repozytorium na GitHubie.
  2. Rozpakuj go do folderu konfiguracji Home Assistant, tego, w którym jest configuration.yaml. Powinien powstać custom_components/wall_dashboard/.
  3. Uruchom ponownie Home Assistant, a potem wykonaj kroki 3 i 4 powyżej.

W Home Assistant OS otwórz ten folder z komputera dodatkiem Samba share albo w Studio Code Server. W instalacjach Container i Core to folder zamontowany lub ustawiony jako config. Folder wall_dashboard nosi techniczną nazwę integracji; w Home Assistant widać ją jako Nucleum Hub.

Otwórz Nucleum Hub z paska bocznego

Otwórz Nucleum Hub z paska bocznego, na koncie administratora. Kreator konfiguracji ma trzy kroki: język i imię do powitania, strony, które chcesz mieć, oraz to, co znalazł w Twoim domu (fotowoltaika, sieć, bateria, pogoda, alarm i więcej), z możliwością poprawek. Naciśnij Utwórz panel.

Twoja konfiguracja jest zapisywana w Home Assistant, a nie w przeglądarce: dlatego każdy ekran pokazuje to samo, a kopie zapasowe Twojego Home Assistant ją zawierają.

Po aktualizacji otwarte już ekrany pokazują przycisk Nowa wersja: dotknij go, aby wczytać nową wersję. Nigdy nie odświeżają się same.

Na tablecie ściennym

  • Adres: otwórz http://homeassistant.local:8123/nucleum-hub, z adresem swojego Home Assistant zamiast homeassistant.local:8123, i zaloguj się raz, zaznaczając opcję pozostania zalogowanym.
  • Fully Kiosk Browser: ustaw ten sam adres jako adres startowy (Start URL).
  • Bez paska bocznego Home Assistant: na tablecie otwórz swój profil (Twoje imię na dole paska bocznego) i włącz opcję, która zawsze ukrywa pasek boczny (po angielsku „Always hide the sidebar”). Działa tylko w tej przeglądarce; aby ją wyłączyć, otwórz na tablecie http://homeassistant.local:8123/profile.

Telefony z aplikacją Home Assistant i osobny panel dla każdego ekranu: Aplikacja Companion i Fully Kiosk.

Jeśli Twój Home Assistant filtruje ruch wychodzący

Integracja łączy się tylko z api.nucleumhub.com (licencja i okres próbny); aktualizacje przychodzą z GitHuba, przez HACS. Twoje ekrany nie łączą się z żadnym z nich.

Instalacja ręczna, awaryjnie

Tylko jeśli integracja nie może działać albo prosi o to nasze wsparcie. Panel to jeden plik z pakietu: custom_components/wall_dashboard/frontend/wall-dashboard.html.

  1. Skopiuj go, razem z leżącym obok folderem wall-dashboard-weather, do folderu www w folderze konfiguracji. Jeśli folderu www nie było, utwórz go i uruchom ponownie Home Assistant.
  2. Ustawienia › Dashboardy › Dodaj dashboard › Strona internetowa, z adresem /local/wall-dashboard.html.

Odczytuje Twoją konfigurację z Home Assistant, więc ekrany wyglądają tak samo. Nowe wersje przychodzą tylko z integracją.