Victron MQTT Integration for Home Assistant (Marketplace integration)

Installs: 1.6k sharing analytics
GitHub stars: 206
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v2026.10.2, October 26, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Brand: Victron
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: victron_mqtt
Source: github.com/tomer-w/ha-victron-mqtt
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Victron MQTT Integration connects Home Assistant to Victron GX devices over the MQTT protocol. It communicates locally and is set up in the UI, and Home Assistant can discover the device on the network by itself. It adds sensors for batteries, solar, grid, inverters and EV chargers, along with binary sensors, numbers, selects, switches, buttons, times and updates. Writable controls cover things such as inverter mode, EV charger current limit, charger current limit and generator start settings. An operation mode setting chooses between read-only entities and the full set including writable ones. Other options include SSL, a username and password, an update frequency mode, a list of excluded devices and simple entity naming for a single Cerbo.

Automatic summary of the README and code of tomer-w/ha-victron-mqtt. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors
Presence

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

Elevate tracing for topicFor debugging purpose only: If substring is in topic those topics will have full traces
Excluded devicesList of devices to exclude from being monitored.
Victron venus host name or IPHostname or IP address of Victron Device, usually mDNS name like 'venus.local'
Operation modeOperation mode controls which Home Assistant entity types are created. 'read_only' exposes only sensors and binary_sensors (no writable entities), 'full' exposes all entity types (sensors, binary_sensors, numbers, selects, switches), 'experimental' is reserved for future use (behaves like 'full' today).
PasswordPassword for the Victron Device, default is empty. This is not your VRM password.
MQTT portThe MQTT port on the host. Normally it is 1883.
Optional root topic prefixRoot topic prefix if used via MQTT gateway.
Simple naming (no installation id in entity ids)Use simple naming for entities, can work only when you have single Cerbo on the network.
Use SSLIndicates whether to use SSL to connect to the Victron Device. Normally it is disabled.
Manual update frequency (seconds)Only used in 'Manual' mode. Update frequency in seconds. Set to 0 to update always.
Update frequency mode'Auto' lets the library choose an update interval per metric (fast-changing values like power update more often). 'Manual' uses the fixed interval below for all metrics.
UsernameUsername for the MQTT server, default is empty. Not needed by Victron devices. This is only needed if you use route your mqtt messages through non Victron server and it does require username.

Ssdp auth

GX Password
Use SSL

After setup

Elevate tracing for topicFor debugging purpose only: If substring is in topic those topics will have full traces
Excluded devicesList of devices to exclude from being monitored.
Victron venus host name or IPHostname or IP address of Victron Device, usually mDNS name like 'venus.local'
Operation modeOperation mode controls which Home Assistant entity types are created. 'read_only' exposes only sensors and binary_sensors (no writable entities), 'full' exposes all entity types (sensors, binary_sensors, numbers, selects, switches), 'experimental' is reserved for future use (behaves like 'full' today).
PasswordPassword for the Victron Device, default is empty. This is not your VRM password.
MQTT portThe MQTT port on the host. Normally it is 1883.
Optional root topic prefixRoot topic prefix if used via MQTT gateway.
Simple naming (no installation id in entity ids)Use simple naming for entities, can work only when you have single Cerbo on the network.
Use SSLIndicates whether to use SSL to connect to the Victron Device. Normally it is disabled.
Manual update frequency (seconds)Only used in 'Manual' mode. Update frequency in seconds. Set to 0 to update always.
Update frequency mode'Auto' lets the library choose an update interval per metric (fast-changing values like power update more often). 'Manual' uses the fixed interval below for all metrics.
UsernameUsername for the MQTT server, default is empty. Not needed by Victron devices. This is only needed if you use route your mqtt messages through non Victron server and it does require username.

Texts from the code of tomer-w/ha-victron-mqtt.

Entities

Binary sensorsIs generic energy meter, Allow to charge, Allow to discharge, Enable remote start mode, Remote start mode, Start generator, Invert digital input, At site, Auto start, EV charging, Connected, Auto-start enabled, and 39 more
ButtonsDevice reboot
PresenceLocation
dynamicState
NumbersPhase, Charge current limit, AC input current limit, Number of phases, Max charging current, Min charging current, Charge current setpoint, Generator cooldown timer, Generator QH start on SoC, Generator QH start on voltage, Generator QH stop on SoC, Generator QH stop on voltage, and 34 more
SelectsPosition, Mode, AC input 1 source type, AC input 2 source type, ESS mode, ESS mode (Hub4), DESS mode, VRM portal access level
SensorsLoad current, Consumption, Feed-in, Error code, Frequency, Phase, Position, Power, Power factor, Voltage, Charge current limit, DC output current, and 280 more
SwitchesEnable remote start mode, Start generator, Invert digital input, Auto start, EV charging, Auto-start enabled, Generator quiet hours enabled, Generator start on SoC enabled, Generator start on high temp enabled, Generator start on voltage enabled, Manual start, Force charge, and 20 more

From the README

A Home Assistant integration that connects to Victron Energy devices using MQTT, providing real-time monitoring of your Victron system including inverters, solar chargers, EV chargers, generators, and battery systems. Over 400 entities in total!!
🔌 Auto-discovery of Victron devices via SSDP (Cerbo GX, etc)
📊 Comprehensive sensor data including:
Battery metrics (voltage, current, power, temperature, state of charge)
Solar/PV metrics (voltage, current, power, yield)
Grid metrics (voltage, current, power, energy)
Inverter metrics (input/output power, frequency)
EV Charger metrics
🕹️ Two-way control over your Victron installation:
inverter mode (On, Off, Charger Only, Inverter Only)
EV Charger (On, Off, current limit)
charger current limit
⚡ Real-time updates via MQTT