Fachbeitrag · Home Assistant · Speicher

Victron in Home Assistant: lokal über MQTT statt VRM

Wer die Daten seiner Victron-Anlage sehen will, landet meist im VRM-Portal. Für Home Assistant ist das der Umweg: Seit Version 2026.5 bringt Home Assistant eine eigene Integration mit, die das GX-Gerät im Heimnetz über MQTT anspricht, ohne Cloud. Dafür muss am GX erst ein Zugang eingeschaltet werden, und bei Batterien mit CAN-bus-BMS braucht das Energie-Dashboard einen Zwischenschritt. Die Integration mit „VRM“ im Namen liefert dagegen etwas ganz anderes, als man erwartet.

Integration
Victron GX, Teil von Home Assistant seit 2026.5, Qualitätsstufe Platin
Verbindung
lokal über MQTT, das GX-Gerät schiebt die Werte (Local Push)
Am Gerät
GX: Settings › Integrations › MQTT Access einschalten
Stand
Home Assistant 2026.10, Dokumentation geprüft am 26.10.2026 · Quellen unten
Autor
Julian Haag, staatlich geprüfter Techniker Elektrotechnik

Das Wichtigste in einer Minute

Drei Integrationen, drei Zwecke

Home Assistant kennt zum Prüfdatum drei Integrationen mit Victron im Namen. Sie ergänzen sich, ersetzen sich aber nicht:

Victron-Integrationen in Home Assistant, Stand 2026.10
IntegrationWegLiefertSeit · Stufe
Victron GXlokal, MQTT des GX-Geräts, PushLive-Werte der ganzen Anlage, dazu einstellbare Entitäten2026.5 · Platin
Victron Remote MonitoringCloud, VRM-API, stündlichPrognosen für Erzeugung und Verbrauch2025.10 · Bronze
Victron BLElokal, Bluetooth, passivMesswerte einzelner Geräte, die „Instant Readout“ senden2025.12 · Bronze

Für eine netzgekoppelte Anlage mit MultiPlus oder Quattro, Laderegler und Batterie ist Victron GX der Kern. Victron selbst schreibt dazu: MQTT-Zugriff ist nur über ein GX-Gerät möglich; Wechselrichter, Laderegler und Batteriemonitore bieten selbst kein MQTT an. Das GX ist das Tor, durch das alle anderen Geräte sprechen.

Drei Wege von Victron nach Home Assistant Links die Quellen, rechts die Integrationen in Home Assistant. Oben: Das GX-Gerät sammelt die Daten von MultiPlus, Laderegler und Batterie und gibt sie über MQTT im Heimnetz an die Integration Victron GX weiter, als Push, lesend und schreibend. Mitte: Das VRM-Portal in der Cloud liefert über die Integration Victron Remote Monitoring einmal pro Stunde Prognosen für Erzeugung und Verbrauch. Unten: Einzelne Geräte senden per Bluetooth ihre Messwerte an die Integration Victron BLE, nur lesend. GX-Gerät MultiPlus · MPPT Batterie · Netzzähler MQTT Access: an lokal, Push Victron GX Live-Werte lesen und einstellen VRM-Portal Cloud, Zugangstoken stündlich Remote Monitoring nur Prognosen Einzelgerät Instant Readout Bluetooth Victron BLE nur lesen Durchgezogen: im Heimnetz · gestrichelt: über die Cloud
Nach der Dokumentation von Home Assistant zu den Integrationen Victron GX, Victron Remote Monitoring und Victron BLE, Stand 2026.10.

Am GX-Gerät: MQTT einschalten

Das ist der häufigste Grund, warum Home Assistant das GX-Gerät nicht findet. Im Handbuch des Cerbo GX steht die Einstellung mit ihrem Werkszustand:

Das Passwort, das Home Assistant später abfragt, ist genau dieses Gerätepasswort. Die Zugangsdaten des VRM-Portals gehören dort nicht hin; die Dokumentation der Integration weist eigens darauf hin.

Gleich mit erledigen: dem GX-Gerät im Router eine feste IP-Adresse geben. Die Integration schlägt als Hostnamen venus.local vor; das klappt nur, wenn das Heimnetz den Namen auflöst.

Einrichten in Home Assistant

Die Integration erkennt GX-Geräte im Netz selbst und bietet sie unter Einstellungen › Geräte & Dienste an. Beim Verbinden versucht sie zuerst TLS auf Port 8883 und, wenn das nicht geht, eine unverschlüsselte Verbindung auf Port 1883.

Verlangt das GX-Gerät eine Anmeldung und beherrscht es die Kopplung per Token, fragt Home Assistant nach dem Pairing-Modus: am Gerät unter Settings › Integrations › MQTT Devices › Pairing mode einschalten oder bei einem GX ohne Bildschirm zweimal kurz auf die eingebaute Taste drücken, dann innerhalb von 120 Sekunden in Home Assistant bestätigen. Die Zugangsdaten legt Home Assistant dann selbst ab. Ohne Token-Kopplung, oder bei manueller Einrichtung, sind diese Felder auszufüllen:

Einstellungen der Integration Victron GX
FeldBedeutung
HostHostname oder IP-Adresse des GX-Geräts, Standard venus.local
Port1883 ohne Verschlüsselung, 8883 mit
Benutzernameleer lassen; root nur, wenn Venus OS gerootet und SSH eingeschaltet ist
Passwortleer beim Profil Unsecured, sonst das Passwort aus dem Sicherheitsprofil
SSLan für Port 8883, aus für Port 1883

Ändert sich später das Passwort oder das Sicherheitsprofil am GX, meldet die Integration eine erneute Anmeldung; nach Eingabe des neuen Passworts lädt sie sich selbst neu.

Was ankommt und was sich einstellen lässt

Welche Entitäten entstehen, hängt davon ab, was am GX hängt. Die Integration legt sie selbst an, und zwar nicht nur Sensoren:

Entitätsarten der Integration Victron GX (Auswahl aus der Dokumentation)
ArtBeispiele
SensorenBatterie: Spannung, Strom, Leistung, Temperatur, Ladezustand; PV: Spannung, Strom, Leistung, Tagesertrag; Netz: Spannung, Strom, Leistung, Energie; Wechselrichter: Ein- und Ausgangsleistung, Frequenz, Zustand
ZahlenLadestromgrenzen, Netz-Sollwert im ESS, Mindest-Ladezustand
AuswahlWechselrichter-Modus (an, aus, nur Laden, nur Wechselrichten), ESS-Modus, Modus des Dynamic ESS
SchalterESS: Laden sperren, Einspeisung sperren; Relais am GX und am Laderegler
ZeitStartzeiten der geplanten Ladung im ESS
TasteGX-Gerät neu starten

Die Werte kommen per Push, sobald das GX-Gerät sie meldet. Damit schnelle Werte die Datenbank nicht fluten, fasst die Integration sie je nach Art in einem eigenen Takt zusammen; laut Dokumentation können sie deshalb kurz verzögert erscheinen.

Die einstellbaren Entitäten schreiben direkt in die Anlage. Ein Mindest-Ladezustand oder ein Netz-Sollwert, den eine Automation setzt, bleibt stehen, bis ihn jemand ändert. Wie man eine Preissteuerung so baut, dass sie bei einem Ausfall nicht in einem ungünstigen Zustand hängen bleibt, steht im Beitrag Victron ESS nach Börsenpreis laden.

Home-Assistant-Dashboard einer Victron-Anlage mit Energiefluss, Ladezustand, Verlaufskurven, PV-Prognose und Ladeplan
Home Assistant an meiner eigenen Victron-Anlage, Stand 19.10.2026: links Energiefluss, Ladezustand und Werte des GX-Geräts, in der Mitte die Verläufe von Laderegler, Netzzähler und MultiPlus-II, daneben Kacheln für die PV-Prognose dieser und der nächsten Stunde, von heute und morgen – die Art Werte, die die VRM-Integration liefert.

Das Energie-Dashboard

Das Energie-Dashboard braucht Zählerstände in kWh, keine Leistungen. Die Integration legt solche Zähler an, aber nicht für jedes Gerät, und bei einem Gerät gibt es zwei, von denen nur einer passt:

Victron-Werte im Energie-Dashboard
BereichQuelleHinweis
NetzNetzzähler: Consumption und Feed-innur mit Netzzähler am GX
Solar, Laderegler (MPPT)Total PV yield systemnicht Total yield, siehe unten
Solar, PV-Wechselrichter am AC-AusgangEnergiezähler des PV-Wechselrichterssofern das GX ihn ausliest
BatterieCharged energy und Discharged energynicht bei Batterien mit CAN-bus-BMS

Laderegler: der Zähler, der sich nicht zurücksetzen lässt

Victron führt im Laderegler zwei Gesamtzähler: /Yield/User, den der Nutzer zurücksetzen kann, und /Yield/System, der nicht zurückgesetzt wird. In Home Assistant heißen sie Total yield und Total PV yield system. Fürs Energie-Dashboard gehört der zweite hinein. Wird der erste in der VictronConnect-App zurückgesetzt, springt sein Zählerstand auf null.

Batterie: die Lücke bei CAN-bus-BMS

Die Zähler Charged energy und Discharged energy stammen aus der Historie des Batteriemonitors. Die Entitätsliste der Integration vermerkt bei beiden: nicht unterstützt bei Batterien mit CAN-bus-BMS. Das betrifft einen großen Teil der Heimspeicher an Victron-Anlagen. Pylontech etwa wird laut der Kompatibilitätsseite von Victron über CAN-bus an das GX-Gerät angeschlossen, am Cerbo GX an den Anschluss BMS-Can.

Was bleibt, ist die Batterieleistung. Victron definiert sie positiv beim Laden und negativ beim Entladen. Daraus werden zwei Zähler:

  1. Zwei Template-Sensoren anlegen, einen für Laden mit dem Wert der Leistung, wenn sie positiv ist, sonst 0, und einen für Entladen mit dem Betrag der Leistung, wenn sie negativ ist, sonst 0.
  2. Für jeden einen Helfer Integral (Riemann-Summe) unter Einstellungen › Geräte & Dienste › Helfer anlegen, mit dem Präfix k und der Zeiteinheit Stunden.
  3. Die beiden Integrale im Energie-Dashboard im Bereich für Batteriespeicher eintragen.

Das Ergebnis ist eine Rechnung, kein gemessener Zähler. Sie driftet über die Zeit, und was Home Assistant nicht aufgezeichnet hat, weil es nicht lief, fehlt. Wie ein Hausmessgerät gegen den Stromzähler abweicht und wie man die Werte abgleicht, steht im Beitrag Energie-Dashboard mit dem Shelly Pro 3EM.

Weniger Daten in der Datenbank

Eine Victron-Anlage meldet viele Werte, und Home Assistant speichert jede Änderung. Die Dokumentation der Integration rät deshalb, nicht gebrauchte Entitäten abzuschalten oder schnell wechselnde Werte per Filter vom Recorder auszunehmen. Was der Recorder wie lange behält und warum die Zähler fürs Energie-Dashboard davon nicht betroffen sind, steht im Beitrag Wie lange speichert Home Assistant Daten?.

Was die VRM-Integration liefert

Wer nach „Victron VRM Home Assistant“ sucht, findet die Integration Victron Remote Monitoring. Sie holt nicht die Messwerte der Anlage, sondern Prognosen aus dem VRM-Portal:

Abgefragt wird einmal pro Stunde. Prognosen gibt es erst, wenn VRM mindestens 30 Tage Daten der Anlage hat, und nur für Anlagen mit PV, deren Verbrauch komplett über Wechselrichter oder einen Netzzähler läuft. Im Energie-Dashboard lässt sich die Erzeugungsprognose bei den Solarmodulen als Prognosequelle auswählen.

Für die Einrichtung braucht es ein Zugangstoken aus dem VRM-Portal. Die Dokumentation warnt: Das Token gewährt vollen Zugriff auf das VRM-Konto, einschließlich der Steuerung der Anlage. Es gehört behandelt wie ein Passwort und nach dem Entfernen der Integration im Portal gelöscht.

Für einen dynamischen Stromtarif ist die Prognose der Teil, den die lokale Integration nicht liefert. Woher eine PV-Prognose sonst kommen kann und wie verlässlich sie ist, steht im Beitrag PV-Prognose in Home Assistant.

Ohne GX-Gerät: Victron BLE

Wo kein GX-Gerät ist, etwa im Wohnmobil mit Laderegler und SmartShunt, hilft Victron BLE. Die Integration liest die verschlüsselten Bluetooth-Meldungen, die Victron-Geräte mit „Instant Readout via Bluetooth“ senden. Unterstützt werden unter anderem SmartSolar- und BlueSolar-Laderegler, SmartShunt und BMV-Batteriemonitore, Smart-Lithium-Batterien, Orion-Ladewandler und MultiPlus oder Quattro über VE.Bus; nicht unterstützt sind zum Prüfdatum Inverter RS im Einzelbetrieb und Multi RS.

Je Gerät braucht die Integration den Schlüssel, den die VictronConnect-App unter Product Info › Instant Readout Details anzeigt. Die Integration liest nur; einstellen lässt sich über Bluetooth nichts. Ist ein Handy mit VictronConnect gerade mit dem Gerät verbunden, sendet es laut Dokumentation womöglich keine Meldungen, und Home Assistant sieht es nicht.

Fallstricke

Häufige Fragen

Brauche ich VRM, um Victron-Daten in Home Assistant zu sehen?

Nein. Die Integration Victron GX verbindet sich im Heimnetz direkt mit dem MQTT-Broker des GX-Geräts und bekommt die Werte geschoben, ohne Cloud. Die Integration Victron Remote Monitoring holt über VRM dagegen nur Prognosen für Erzeugung und Verbrauch, einmal pro Stunde, keine Live-Werte.

Warum findet Home Assistant meinen Cerbo GX nicht?

Meist ist der MQTT-Zugang am GX-Gerät ausgeschaltet. Victron liefert ihn ab Werk deaktiviert aus; eingeschaltet wird er unter Settings, Integrations, MQTT Access. Victron schreibt dazu, dass er nur gebraucht wird, wenn ein Dienst wie Home Assistant über das lokale Netz auf den MQTT-Broker zugreifen soll.

Welches Passwort will Home Assistant für den Victron GX?

Das Passwort des lokalen Sicherheitsprofils am GX-Gerät, nicht die Zugangsdaten des VRM-Portals. Steht das Profil auf Unsecured, bleibt das Feld leer. Neuere GX-Geräte unterstützen eine Kopplung per Token: Pairing-Modus am Gerät einschalten und innerhalb von 120 Sekunden in Home Assistant bestätigen.

Warum fehlen bei meiner Pylontech-Batterie die Energiezähler?

Die Zähler für geladene und entladene Energie liefert laut Entitätsliste der Integration keine Batterie mit CAN-bus-BMS. Pylontech wird nach Victron über CAN-bus an das GX-Gerät angeschlossen. Fürs Energie-Dashboard bleibt dann die Batterieleistung, die man mit dem Helfer Integral in zwei Zähler für Laden und Entladen umrechnet.

Kann Home Assistant das Victron-System auch steuern?

Ja. Die Integration Victron GX legt neben Sensoren auch einstellbare Entitäten an, darunter den Netz-Sollwert und den Mindest-Ladezustand im ESS, Ladestromgrenzen, den Wechselrichter-Modus, den ESS-Modus und den Modus des Dynamic ESS. Was davon für einen dynamischen Stromtarif sinnvoll ist, behandelt der Beitrag zur Victron-ESS-Steuerung nach Börsenpreis.

Quellen

Die Angaben zu den Integrationen stammen aus der Dokumentation von Home Assistant und der dort verlinkten Entitätsliste, die zum GX-Gerät aus dem Handbuch und dem Entwicklerwiki von Victron. Die Anlage hinter dieser Website ist ein Victron-System mit MultiPlus-II, SmartSolar-Laderegler und Pylontech-Speicher; das Bild oben stammt von dort. Was hier steht, gilt für den Stand vom 26.10.2026; die Integration Victron GX ist jung und ändert sich schnell.

Haag Automation steht mit Victron Energy in keiner geschäftlichen Beziehung. Einstellungen, die über Home Assistant in die Anlage geschrieben werden, verändern ihr Verhalten; die Verantwortung dafür bleibt beim Betreiber.

Sie wollen Ihre Victron-Anlage sauber in Home Assistant holen, mit Speicher im Energie-Dashboard? Ich richte es mit Ihnen ein – das Erstgespräch ist kostenlos.