Hilfe & Support

Alles für einen guten Start.

Helios liest alles aus Ihrem Home Assistant Energie-Dashboard.
Richten Sie einfach das Energie-Dashboard ein, und die Karte läuft, ganz von selbst.

Einrichtung

Richten Sie zuerst Ihr Energie-Dashboard ein.

  1. 1

    Öffnen Sie die Einstellungen des Energie-Dashboards

    Gehen Sie in Home Assistant zu Einstellungen, Dashboards, Energie. Das ist die einzige Stelle, aus der Helios seine Daten bezieht: Alles, was Sie hier einstellen, landet direkt in der Karte.

  2. 2

    Fügen Sie Ihre Quellen hinzu

    Fügen Sie Ihr Stromnetz hinzu (den Bezug, und die Einspeisung, falls Sie Strom verkaufen), Ihre Solarproduktion und Ihre Batterie. Jede Quelle zeigt auf den kWh-Energiesensor, den Ihre Integration ohnehin schon liefert.

  3. 3

    Fügen Sie die optionalen Leistungssensoren hinzu

    Für sekundengenaue Werte geben Sie jeder Quelle zusätzlich ihren optionalen Leistungssensor (W), nicht nur den in kWh. Ohne ihn haben die Plaketten keinen Echtzeitwert; der Verlauf bleibt dank der kWh-Sensoren verfügbar.

  4. 4

    Setzen Sie eine Helios-Karte auf ein Dashboard

    Das war's. Fügen Sie die Karte hinzu (type: custom:helios-card), und sie greift alles automatisch ab. Keine Entität muss Karte für Karte verdrahtet werden.

Die vollständige Anleitung: die Home Assistant Energie-Dokumentation.

FAQ

Die Fragen, die am häufigsten kommen.

Die Karte ist leer oder zeigt keine Daten an.

Helios liest alles aus Ihrem Home Assistant Energie-Dashboard. Prüfen Sie, ob es richtig eingerichtet ist (Einstellungen, Dashboards, Energie), mit mindestens einer Solar-, Netz- oder Batteriequelle. Ist das Energie-Dashboard leer, hat die Karte nichts anzuzeigen.

Die Live-Werte zeigen Striche an oder bleiben eingefroren.

Die Energiesensoren (kWh) speisen den Verlauf und die Diagramme, aber die momentanen Werte brauchen an jeder Quelle einen Leistungssensor (W). Fügen Sie dieser Quelle den optionalen Leistungssensor in Ihrem Home Assistant Energie-Dashboard hinzu. Ohne ihn haben die Plaketten keinen Echtzeitwert (sie bleiben auf einem Strich); der Verlauf und die Kurven laufen dank der kWh-Sensoren weiter.

Mein Haus wird falsch dargestellt, oder nur zur Hälfte.

Die 2.5D-Szene stützt sich auf den OpenStreetMap-Grundriss Ihres Gebäudes. Prüfen Sie, ob es auf openstreetmap.org mit korrektem Grundriss vorhanden ist; fehlt es dort, tragen Sie es ein und geben Sie ihm Zeit, sich zu verbreiten. Auf sehr alten Geräten kann außerdem die Rendering-Grenze des Browsers die Szene beschneiden.

Es wird nichts angezeigt, oder die Szene ist am falschen Ort.

Helios zentriert sich auf den Heimatstandort, der in Home Assistant festgelegt ist (Einstellungen, System, Allgemein). Im visuellen Editor können Sie Karte für Karte einen anderen Standort festlegen, falls eine Karte woanders hinzeigen soll.

Woher kommt das Wetter? Werden meine Daten irgendwohin geschickt?

Einstrahlung und Bewölkung kommen von Open-Meteo, ohne API-Schlüssel, und Karte und Gebäude von OpenStreetMap, ausgeliefert als Vektorkacheln von OpenFreeMap. Alles andere sind Ihre eigenen Home-Assistant-Daten. Es gibt keinen Helios-Server, kein Konto und keine Telemetrie: Ihre Energiezahlen verlassen Ihre Instanz nie, und diese Dienste bekommen immer nur einen ungefähren Standort, nie Ihre genauen Koordinaten.

Kann ich Helios von Hand mit meinen Entitäten verbinden, statt über das Energie-Dashboard?

Nein, das ist eine bewusste Entscheidung, zu der ich voll und ganz stehe. Helios liest zu 100 % aus Ihrem Home Assistant Energie-Dashboard, und das bleibt für immer so. Genau das hält die Karte wirklich einfach in der Einrichtung, selbst wenn man gerade erst anfängt, und lässt sie mit jeder Art von Installation klarkommen, ohne Sie unter Optionen zu begraben. Und diese eine einzige Datenquelle sorgt für stimmige Zahlen, egal ob im Energie-Dashboard oder in Helios. Ich habe vor, noch vieles hinzuzufügen und zu ändern, aber Entitäten Karte für Karte zu verbinden wird nie dazugehören.

Meine Batterie oder mein Netz zeigt die falsche Richtung an.

Manche Sensoren melden das umgekehrte Vorzeichen. Bei der Batterie drehen Sie es im visuellen Editor von Helios mit der Option für das Batterie-Vorzeichen um (standardmäßig, invertiert oder ausgeblendet). Beim Netz kommt die Richtung aus Ihrem Home Assistant Energie-Dashboard: Stellen Sie dort den Leistungssensor dieser Quelle auf Standard oder Invertiert.

Wie funktioniert die Solarprognose?

Die Prognose kommt aus der separaten Integration Helios Forecast, die sie vollständig auf Ihrer eigenen Instanz berechnet und ins Energie-Dashboard einspeist. Auf der Helios-Forecast-Seite erfahren Sie, wie sie funktioniert.

Ich habe einen Bug gefunden, oder ich habe eine Idee.

Eröffnen Sie ein Issue im GitHub-Repository. Die Formulare führen Sie zu den wenigen Angaben (Ihre Kartenkonfiguration, ein Screenshot, die Browser-Konsole), mit denen sich das schnell beheben lässt.

Kommen Sie trotzdem nicht weiter? Eröffnen Sie ein Issue im Helios-Repository, oder, für die Prognosen, bei Helios Forecast.

Warum ich sie gebaut habe

Wir können das Ruder noch herumreißen.

Ich bin Jérôme, 44 Jahre, der Entwickler hinter Helios. Nach Jahren quer durch den ganzen Stack, Backend, Frontend, 3D, Games, Embedded, wollte ich etwas schaffen, das mir wirklich am Herzen liegt.

Eine Karte wird den Planeten nicht retten, das weiß ich. Aber Schuldgefühle und Zahlen, die niemand liest, ändern niemanden: Man ändert sich, wenn man endlich sehen kann, was im eigenen Zuhause passiert. Genau darum geht es bei Helios: Energie sichtbar machen, greifbar, sogar schön, damit Handeln keine Pflicht mehr ist, sondern selbstverständlich wird.

Helios ist kostenlos und Open Source, entwickelt von einer einzigen Person, in aller Transparenz.

ReikanYsora - Jérôme CREMOUX - 2026