victron-venus

Wiki

Documentation

Everything needed to go from a stock Cerbo GX to the full open stack — and the standards that keep the codebase maintainable.

Where to start

  1. Skim the architecture — five layers, two buses (D-Bus on-device, MQTT everywhere else). Two minutes well spent before installing anything.
  2. Follow the install guide for your hardware layer. Each step is independent; adopt only what you need.
  3. Dive into Venus OS integration when writing your own service — service naming, MQTT topics, PackageManager installs.
  4. Before your first PR, read contributing and the CI standards every repo here follows.

All pages

Read the September 2026 service audit closure for verified deployment fixes, meter-exchange evidence and validation limits.

01

Install guide

Layer-by-layer setup from flashing an ESP32 to a running dashboard.

 02

Architecture

The five layers and why control data stays on D-Bus while telemetry rides MQTT.

 03

Venus OS integration

com.victronenergy.* naming, MQTT topic conventions, PackageManager.

 04

CI standards

Reusable workflows, SHA pinning, release rules, version sync.

 05

Contributing

Fork → branch → PR flow, conventional commits, local checks.
Safety first. These projects control real inverters and batteries. Read the control-change review requirements before enabling automated control, and never test charge/discharge policies without a way to cut them off.