Voltronic Solar Inverter to Home Assistant via MQTT with docker-voltronic-mqtt

Share your Projects!
, ,
1

After years of struggling with existing solutions to integrate Voltronic inverters with Home Assistant, I decided to create my own: docker-voltronic-mqtt. It’s been running reliably for several months now, and I’m excited to share it with the community.

What is it?
This application reads data from Voltronic inverters (via usb/serial, supporting PI30/PI41 protocols) and seamlessly pushes it to Home Assistant via MQTT.

Features:

  • Exposes essential inverter data: grid voltage, battery SOC, load wattage, PV input, and more.
  • Supports warnings and advanced metrics like heatsink temperature and SCC voltage.
  • Simple deployment via Docker—no complex setup required.

How to Get Started:

  1. Run the following command (replace placeholders with your MQTT server details and USB port):
docker run -t -i --privileged -v /dev:/dev --restart=always --name voltronic-mqtt --pull=always \
-e MQTT_PASSWORD='your_password' \
-e MQTT_SERVER='your_server' \
-e MQTT_USER='your_username' \
-e SERIAL_PORT='/dev/ttyUSB0' \
lavron/voltronic-mqtt:latest
  1. Integrate with Home Assistant by appending the ha-sensors.yaml file from the repo to your configuration.yaml.

I’d love to hear your feedback or suggestions, and if you give it a try, let me know how it works for you!

3 Likes
2

Thank you!!
I’ve been looking for solutions like this!

Do you know if it will work on the axpert king? what is the protocol axpert king has?

Also, any idea if I can use it to integrate it with Venus OS?

3

It should work with Axpert Inverters. Let me know if it wouldn’t work for yours.

To integrate with Venus OS the easiest way is to get data via mqtt. I’m not familiar with Venus OS, so details may vary.
Another option is to run the source code directly on the server, but it should be modified slightly.
Reach me out in pm if you need assistance, I’m curious.

4

Thanks for all your effort, after following your instructions I got the values to display in HA. Just one question of modifying inverter mode, is it possible to post a MQTT command to change the inverter mode? I am not to much familiar with MQTT at this moment. Also if it is possible to change the battery charging current via home assistant.

5

We got a solution here:

I’m planning on adding this functionality to the next release.

6

Would this allow me to send data from my eco-worthy inverter to home assistant and send commands back from home assistant to either charge my batteries or power my house?

I am debating buying Solar Assistant, not sure if it would make the setup any easier?