Skip to content

Installation

Requirements

Hardware

Component Description
Battery Marstek Venus E v2/v3, Venus A or Venus D
Modbus converter RS485 → Modbus TCP device (e.g. Elfin-EW11) — Venus E v2 only. Venus E v3, Venus A and Venus D connect via Ethernet and support Modbus TCP natively.
Grid sensor HA sensor measuring total grid consumption (e.g. Shelly EM3, Neurio, smart meter integration)

Software

  • Home Assistant 2024.1.0 or later
  • (Optional) Solar forecast sensor for predictive charging (Solcast, Forecast.Solar, etc.)

Network

The battery must be reachable from Home Assistant by IP on the same network segment or via routing.

  1. Click the button to add the repository to HACS:

    Add to HACS

  2. Search for "Marstek Venus Energy Manager" and install.

  3. Restart Home Assistant.

HACS search

Manual installation

  1. Download the zip from the latest release at GitHub Releases.
  2. Extract the marstek_venus_energy_manager folder.
  3. Copy it to the custom_components/ directory of your Home Assistant instance.
  4. Restart Home Assistant.

Adding the integration

After installing and restarting:

  1. Go to Settings → Devices & Services.
  2. Click + ADD INTEGRATION.
  3. Search for Marstek Venus Energy Manager.
  4. Follow the configuration wizard.

Add integration in HA