Install Omnibattery¶
Install the integration, connect a supported battery and choose the Home Assistant sensor that measures your home's grid exchange. You can finish a basic setup first and add forecasts, schedules and price-based charging later.
Already using Marstek Venus Energy Manager? Stop here and follow Upgrading from Marstek VEM to preserve your configuration and history.
Check whether your exact battery is compatible before installing.
Before you start¶
You need:
- Home Assistant 2024.4.1 or later
- a supported battery reachable from Home Assistant
- a Home Assistant power sensor that measures total grid import and export in watts or kilowatts
The battery or its bridge must be reachable over the relevant local connection. A grid sensor is required because Omnibattery uses it to decide how much the batteries should charge or discharge.
| If you have | Prepare this before setup | Connection |
|---|---|---|
| Marstek Venus E v2/v3, Venus A or Venus D | Enable or add the connection described in the Marstek guide. | Modbus TCP, Modbus RTU over USB–RS-485, or a LilyGo RS-485/ESPHome bridge for Venus E v2 |
| Zendure SolarFlow 800, 800 Plus, 800 Pro, 1600 AC+, 2400 AC+, 2400 AC Pro, 3000 Mix AC+, 4000 Mix AC+ or 4000 Mix Pro | Keep the manufacturer's HEMS control disabled so it does not replace Omnibattery's power request. | Local HTTP API |
| Anker SOLIX Solarbank Max AC, Solarbank 4 E5000 Pro or Solarbank XE AC | Enable Third-Party Control in the Anker app and disconnect any other Modbus client. | Modbus TCP |
| Huawei SUN2000 + LUNA2000 | Prepare the inverter's Modbus connection. The default control method also needs the Huawei Solar integration. | Modbus TCP through the inverter or a shared proxy |
| Sessy Home Battery | Have the local credentials printed on the Sessy dongle available. | Local HTTP API |
| Hoymiles MS-A2 or HiBattery | Configure Home Assistant's MQTT integration and a local MQTT broker, then enable MQTT Service in S-Miles Home. | MQTT through Home Assistant |
| Indevolt SolidFlex or PowerFlex | In the Indevolt app, enable the local API with HTTP and select the Realtime working mode. | Local HTTP API |
Use a responsive grid sensor
An update every 1–2 seconds is recommended. Sensors that publish every 10 seconds or more are accepted, but Omnibattery raises a Repairs warning because delayed readings reduce control quality. The latest reading remains valid for up to 65 seconds.
See Main sensor for sign conventions, units and meter-specific guidance.
Optional information¶
You can leave these fields empty or disabled during the first setup and add them later through Settings → Devices & services → Omnibattery → Configure:
- Solar forecast remaining today for predictive charging and solar charge delay
- Solar production sensor when an external inverter measures panels that do not feed the battery's own solar inputs
- Off-grid power sensor when a separate meter measures the backed-up circuit
- Three-phase current protection when phase-current sensors are available; see Three-phase current protection
Set Maximum contracted power to the actual import limit for your home. Omnibattery uses it as a charging safety ceiling.
Connection details by battery type
Marstek: Venus E v2 needs an RS-485 connection, such as a USB adapter or an RS-485-to-TCP converter. Venus E v3, Venus A and Venus D can use their network connection. The LilyGo path requires the supported ESPHome firmware and its stock Home Assistant entities.
Zendure, Sessy and Indevolt: Home Assistant must be able to reach the device's local HTTP endpoint. Omnibattery communicates locally rather than through a manufacturer cloud account.
Anker: its Modbus server accepts one client at a time. Close another integration or tool before Omnibattery tests the connection.
Huawei: Omnibattery reads through the SUN2000 inverter. By default, control commands use Huawei Solar services; direct Modbus writes are an optional setup choice.
Hoymiles: Omnibattery uses Home Assistant's configured MQTT broker. It does not install or manage a broker.
Install with HACS¶
Home Assistant Community Store (HACS) is the recommended installation method.
-
Use the button below to add the repository to HACS.
-
In HACS, search for Omnibattery and select Download.
- Restart Home Assistant when HACS asks you to.
Install manually¶
- Download the zip file from the latest Omnibattery release.
- Extract the
omnibatteryfolder into your Home Assistantcustom_componentsdirectory. - Confirm the resulting path is
custom_components/omnibattery/manifest.json. - Restart Home Assistant.
Add the integration¶
- Open Settings → Devices & services.
- Select Add integration and search for Omnibattery.
- Choose your grid sensor and enter your installation's electrical settings.
- Add each battery, then finish or configure the optional time slots, excluded devices and predictive charging sections.

The configuration guide explains each page of the setup wizard.
Check the result¶
After the wizard finishes:
- open the Omnibattery sidebar panel and confirm that Grid, Home and Battery show plausible power values
- open Batteries and confirm that each battery reports its state of charge (SOC) and power
- open Control to enable only the optional features you want
If the battery is unavailable or its values have the wrong sign, use the relevant battery setup guide and Troubleshooting before enabling automatic control.
Blueprint installation¶
Blueprints are optional and are installed separately from the integration. Omnibattery works without them. When the basic integration is operating correctly, see Blueprints for Home Assistant and manual installation steps.