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