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!

2 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.