Victron BLE → MQTT → Home Assistant (No VRM) – Full Offline Pi4 Setup w/ Guide

curtalfrey · August 8, 2025, 12:42am

Hey all,

I’ve built a fully offline, headless Raspberry Pi 4 integration that scans Victron SmartShunts and MPPTs over BLE and publishes them to MQTT for use in Home Assistant. It’s ideal for setups without a Cerbo GX or cloud connection.

Install Guide:

github.com/curtalfrey/victron-ble2mqtt-integration

Victron_BLE_to_MQTT_Integration_Setup_Guide.md

6e15054e6

# Victron BLE to MQTT Integration Setup Guide

This guide walks through the complete setup of a Raspberry Pi 4 running Raspberry Pi OS Lite to scan Victron BLE devices (e.g., SmartShunts, MPPTs), publish the data to MQTT, and integrate with Home Assistant. No GUI required. Copy-paste friendly.

---

## Table of Contents

1. [Initial Pi Setup](#1-initial-pi-setup)
2. [Enable Wi-Fi with Static IP](#2-enable-wi-fi-with-static-ip)
3. [Python Virtual Environment Setup](#3-python-virtual-environment-setup)
4. [Clone Repositories](#4-clone-repositories)
5. [Apply Integration Fixes](#5-apply-integration-fixes)
6. [Systemd Service Configuration](#6-systemd-service-configuration)
7. [Mosquitto MQTT Broker Setup](#7-mosquitto-mqtt-broker-setup)
8. [Home Assistant Integration](#8-home-assistant-integration)
9. [Auto-Start on Boot](#9-auto-start-on-boot)
10. [Reboot Test](#10-reboot-test)

---

This file has been truncated. show original

Repo:

It covers:

Static IP + Wi-Fi config
Python venv setup
Systemd service
MQTT broker (Mosquitto)
Home Assistant dashboard
Full reboot persistence

I’d love a peer review of the guide and repo from the HA and Victron DIY crowd. Let me know if anything is unclear or missing.

Thanks for checking it out!

dt_ryan · December 2, 2025, 3:45pm

I am getting a request for username/password when trying to pull from Github in step 4. Is there a default that should be used?

MakinDisDoDat · December 11, 2025, 4:01pm

I also have a PI 4 setup with python code to monitor my Victron charge controller and shunt and wanted to allow that data to be access in HA. I get the following error when I click on either of the items above:

No server is currently available to service your request.

I am very interested in seeing how you have set it up.