Hi all,
I’ve put together a Home Assistant add-on called Venus OS Local.
The goal is simple: run Victron Venus OS locally inside Home Assistant so you can keep the Venus web UI, MQTT, and Modbus TCP on the same machine as Home Assistant, instead of needing a separate Venus GX device for this setup.
Right now this add-on is aimed at a specific hardware path:
- Home Assistant OS on aarch64
- Victron MK3-USB adapter
- VE.Bus MultiPlus inverter
What it gives you:
- Venus OS web UI inside Home Assistant
- A Home Assistant sidebar entry called Victron
- OPEN WEB UI support from the add-on page
- Local Modbus TCP on port 502
- Local MQTT on port 1883
This is a custom add-on, not an official Victron or Home Assistant release, but it may be useful if you want a simple local Venus setup on your HA box.
Install Instructions
- In Home Assistant, go to Settings > Add-ons > Add-on Store.
- Open the menu in the top-right and select Repositories.
- Add this repository URL:
https://github.com/usersaynoso/Victron-Venus-OS-for-Home-Assistant
- Find Venus OS Local in the add-on store and open it.
- Go to the Configuration tab.
- Select your serial_device.
Use a stable path under /dev/serial/by-id/… if possible, for example:
serial_device: /dev/serial/by-id/usb-VictronEnergy_MK3-USB_Interface_HQ22457CDAZ-if00-port0
- Start the add-on.
Important:
- The add-on will not start properly and OPEN WEB UI will stay unavailable until serial_device is selected.
- Avoid using /dev/ttyUSB0 if you can; /dev/serial/by-id/… is the better option.
Once started, you can open Venus from:
- OPEN WEB UI in the add-on
- The Victron sidebar item
- Or directly at http://:80/gui-v2/
Notes
- First load can take a little while while values populate.
- This is currently focused on the MK3-USB + VE.Bus setup on aarch64.
- If you try it, feedback and test results on similar Victron setups would be useful.
GitHub repo: