Dokumentation

Installation

Nucleum Hub ist eine kleine Home-Assistant-Integration. Installiere sie einmal auf deinem Home Assistant, und sie erscheint in der Seitenleiste jedes Bildschirms. Sie ist ein einziges Paket: Das Dashboard, seine Bilder und die Integration kommen zusammen, und du kopierst nie eine Datei von Hand.

Bevor du anfängst

  • Home Assistant 2026.3 oder neuer, auf jeder Installationsart: Home Assistant OS, Container, Core oder Supervised.
  • Ein Administratorkonto, für die Installation und den ersten Start.
  • HACS, wenn du den Weg mit einem Klick willst. Ohne HACS nimm das ZIP.
  • Internet für Home Assistant, wenn du die Integration hinzufügst: Sie startet deinen 60-minütigen Test bei unserem Server.
  • Browser: Chrome / Edge 105+, Safari 16+, Firefox 121+. Unsicher wegen deines Tablets? Öffne zuerst die Demo darauf.

1. Unser Repository zu HACS hinzufügen

Nucleum Hub steht nicht in der Standardliste von HACS: Du fügst unser Repository einmal als benutzerdefiniertes Repository zu HACS hinzu.

  • Mit einem Klick: Öffne Mit My Home Assistant zu HACS hinzufügen. Das öffnet deinen Home Assistant und bittet HACS, unser Repository hinzuzufügen; bestätige mit Hinzufügen.
  • Von Hand: Öffne in HACS das Menü ⋮ › Benutzerdefinierte Repositories, füge https://github.com/iulianmara/nucleum-hub ein, wähle den Typ Integration und drück auf Hinzufügen.

2. Herunterladen und neu starten

  1. Öffne in HACS Nucleum Hub und drück auf Herunterladen.
  2. Starte Home Assistant neu: Einstellungen › System › Neu starten.

3. Die Integration hinzufügen

Einstellungen › Geräte & Dienste › Integration hinzufügen › Nucleum Hub, dann Absenden. Nucleum Hub erscheint in der Seitenleiste, auf jedem Bildschirm, der bei deinem Home Assistant angemeldet ist, und dein 60-minütiger Test beginnt: alle Funktionen, am Stück, einmal pro Home-Assistant-Installation.

4. Deinen Lizenzschlüssel einfügen

Eine Lizenz gekauft? Dein Schlüssel kommt von uns per E-Mail, direkt nach der Zahlung.

  1. Öffne Einstellungen › Geräte & Dienste › Nucleum Hub › Konfigurieren.
  2. Füge den Schlüssel ein und bestätige. Groß- und Kleinschreibung sowie Leerzeichen spielen keine Rolle.
  3. Die Integration aktiviert ihn einmal online und prüft ihn danach selbst bei unserem Server. Bewahre die E-Mail auf: Wir speichern nur einen Fingerabdruck des Schlüssels.

Zuhause ohne Internet, Umzüge und die Testinstallation: Lizenz und Aktivierung.

Ohne HACS: das ZIP

  1. Lade das ZIP aus der neuesten Version unseres Repositorys auf GitHub herunter.
  2. Entpacke es in den Konfigurationsordner deines Home Assistant, den Ordner mit der configuration.yaml. Am Ende sollte es custom_components/wall_dashboard/ geben.
  3. Starte Home Assistant neu und folge dann den Schritten 3 und 4 oben.

Bei Home Assistant OS öffnest du diesen Ordner vom Computer aus mit dem Add-on Samba share oder mit Studio Code Server. Bei Container und Core ist es der Ordner, den du als config eingebunden oder festgelegt hast. Der Ordner wall_dashboard trägt den technischen Namen der Integration; in Home Assistant erscheint sie als Nucleum Hub.

Nucleum Hub in der Seitenleiste öffnen

Öffne Nucleum Hub über die Seitenleiste, mit einem Administratorkonto. Der Einrichtungsassistent hat drei Schritte: deine Sprache und ein Name für die Begrüßung, die Seiten, die du willst, und was er in deinem Zuhause gefunden hat (Solar, Netz, Batteriespeicher, Wetter, Alarmanlage und mehr), was du korrigieren kannst. Drück auf Dashboard erstellen.

Deine Einrichtung wird in Home Assistant gespeichert, nicht im Browser: Deshalb zeigt jeder Bildschirm dasselbe, und deshalb ist sie in deinen Home-Assistant-Backups enthalten.

Nach einem Update zeigen bereits geöffnete Bildschirme die Schaltfläche Neue Version: Tipp darauf, um die neue Version zu laden. Sie laden nie von selbst neu.

Auf einem Wandtablet

  • Die Adresse: Öffne http://homeassistant.local:8123/nucleum-hub, mit der Adresse deines Home Assistant statt homeassistant.local:8123, und melde dich einmal an, mit „Angemeldet bleiben“.
  • Fully Kiosk Browser: Nimm dieselbe Adresse als Start-URL.
  • Ohne die Seitenleiste von Home Assistant: Öffne auf dem Tablet dein Profil (dein Name, unten in der Seitenleiste) und schalte die Option ein, die die Seitenleiste immer ausblendet (auf Englisch „Always hide the sidebar“). Sie gilt nur für diesen Browser; zum Ausschalten öffnest du auf dem Tablet http://homeassistant.local:8123/profile.

Handys mit der Home-Assistant-App und ein eigenes Dashboard für jeden Bildschirm: Companion-App und Fully Kiosk.

Wenn dein Home Assistant ausgehenden Verkehr filtert

Die Integration spricht nur mit api.nucleumhub.com (Lizenz und Test); Updates kommen von GitHub, über HACS. Deine Bildschirme sprechen mit keinem von beiden.

Manuelle Installation, als Notlösung

Nur wenn die Integration nicht laufen kann oder unser Support dich darum bittet. Das Dashboard ist eine einzige Datei im Paket: custom_components/wall_dashboard/frontend/wall-dashboard.html.

  1. Kopiere sie, mit dem Ordner wall-dashboard-weather daneben, in den Ordner www deines Konfigurationsordners. Gab es keinen Ordner www, lege ihn an und starte Home Assistant neu.
  2. Einstellungen › Dashboards › Dashboard hinzufügen › Webseite, mit der Adresse /local/wall-dashboard.html.

Sie liest deine Einrichtung aus Home Assistant, deshalb sehen deine Bildschirme gleich aus. Neue Versionen kommen nur mit der Integration.