Energy

victron

sfstar/hass-victron · vv0.6.4

HACSLocal polling

Integration for Home Assistant to fetch data from the victron gx device via modbusTCP

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`switch`	Switch or outlet
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`button`	Button (as a switch)
`select`	Mode picker (as switches)

What people report

Local Modbus TCP integration for Victron GX systems; firmware updates and pymodbus changes need compatibility fixes.

Works3
Partly works2
Not working1

Device	In Home Assistant	What they said	Source
Victron Cerbo GX	Works Local	Modbus TCP setup; early division by zero error fixed in later releases Saved copy Hello, I tried to use your integration over HACS with my newly installed Victron system but failed at the first step. I used the IP address which is statet on the router page: The port number is untouched: It tells me Success! but your integration shows an error: The log tells me nothing I understand: home-assistant_victron_2022-12-15T21-38-48.144Z.log The Modbus TCP services page on my Cerbo GX tells me following ids: The last Modbus/TCP error occurred at the time of configuration of the integration: The Firmware of the Cerbo GX is v2.92 The Firmware of the MultiPlus-II 48/5000/70-50 is 497 … Excerpt saved from GitHub on 2026-10-23.	Issue #11 · 2022-12
Victron Energy	Works Local	Integrates locally through a HACS add-on with many data points Saved copy Using Victron Energy and it integrates locally through a HACS add-on. I now have a gazillion data points to play with .... Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2024-03
Victron tank sensors	Works Local	Undocumented status code 5 handled Saved copy support error status being returned for tank sensors. which is an undocumented value. Addresses #102 Excerpt saved from GitHub on 2026-10-23.	PR #194 · 2024-03
Victron GX firmware 3.79	Partly works Local	Needs compatibility fixes in open PR after upgrading to 3.79 Saved copy Fixes seen after upgrading a GX to firmware 3.79, plus several related robustness fixes. Several of these re-apply existing open PRs; crediting them below. Register-level changes were verified against Victron's official Modbus-TCP register list (Rev 54, workbook modified 2026-09-28, from `victronenergy/dbus_modbustcp`). ## Changes - `vebus_microgrid_error` (reg 231): pass `entityType=` as a keyword so it isn't bound to the positional `unit` arg, which produced a non-serializable `unit_of_measurement` and 500'd `/api/states` on HA 2026.7+. (ref #456) - `battery_balancer_status`: moved register … Excerpt saved from GitHub on 2026-10-23.	PR #468 · 2026-10
Victron Multiplus with battery	Partly works Local	No kWh battery entities; energy dashboard needs integration helper Saved copy … opening this issue. Currently I'm using the following entities to track my batteries usage: Whereby the acin2 to inverter doesn't see any current (my multiplus doesn't have an acin2). Otherwise I couldn't add the feedin and the self consumption (Since HA doesn't allow for multiple in / out trackers in the same battery system). Do you have an system with an can-bms battery? (Still waiting on shipping for my can-bms battery and currently using an voltage based highly inaccurate battery monitorin Excerpt saved from GitHub on 2026-10-23.	Issue #10 · 2022-12
Victron VE.Bus microgrid	Not working Local	Microgrid entities crash recorder statistics; fix PR closed Saved copy Problem `vebus_microgrid_error` (register 231, `vebus_registers_4`) passes `TextReadEntityType(microgrid_error)` positionally into the `unit` slot of `RegisterInfo`, and `vebus_microgrid_heartbeat` (register 230) passes the integer `1` the same way. The existing guard in `RegisterInfo.init` only checks the `entityType` keyword, so the entity ends up with a non-string `unit_of_measurement`. The consequences (see #444, and #438 which this likely also explains): - The HA websocket cannot serialize the state → frontend errors, entity invisible in the UI - Worse: every recorder `StatisticsTask` … Excerpt saved from GitHub on 2026-10-23.	PR #452 · 2026-07

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local polling

Talks to the device on your network, asking it for updates every so often.

Details

Installs (analytics)	1,879 (0.27%)
GitHub stars	322
Latest version	v0.6.4 (2026-02-07)
Set up in the UI	Yes
Maintainers	@sfstar
License	Apache-2.0

Limitations from the README

Configuring the integration will be relatively slow if a discovery scan is required.
This integration wasn't tested with a three-phase system. Although basic functionality should work minor bugs could have gone unnoticed

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

Fork	Stars	Last push	Description
remcom/hass-victron	★ 64	2025-04-25	Integration for Home Assistant to fetch data from the victron gx device via modbusTCP
stefanschoemaker/hass-victron Newer code	★ 0	2026-08-04	Integration for Home Assistant to fetch data from the victron gx device via modbusTCP
denbrian/hass-victron Newer code	★ 0	2026-10-19	Integration for Home Assistant to fetch data from the victron gx device via modbusTCP

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/sfstar/hass-victron
Source code: https://github.com/sfstar/hass-victron
Issues: https://github.com/sfstar/hass-victron/issues
HACS: https://hacs.xyz