
Use your home battery to reduce grid costs¶
Omnibattery connects compatible home batteries to Home Assistant so they can follow household demand, store available solar energy and charge when your schedule or electricity price makes it worthwhile.
Is Omnibattery for me?¶
Use it if you already have a supported battery and a Home Assistant sensor that measures power imported from or exported to the grid. It is especially useful when you want one place to coordinate batteries, solar forecasts, electricity prices and household loads.
You do not need it if the manufacturer's own control already meets your needs, or if you only want to view battery data without Home Assistant adjusting battery power.
Check whether your exact battery is compatible before installing.
Supported brands at a glance¶
| Brand | How Omnibattery connects | Start here |
|---|---|---|
| Marstek Venus | Modbus TCP, Modbus RTU or a LilyGo RS-485/ESPHome bridge | Marstek setup |
| Zendure SolarFlow | Local HTTP API | Zendure setup |
| Anker SOLIX Solarbank | Modbus TCP | Anker SOLIX setup |
| Huawei SUN2000 + LUNA2000 | Modbus TCP through the inverter | Huawei setup |
| Sessy Home Battery | Local HTTP API through the Sessy dongle | Sessy setup |
| Hoymiles MS-A2 and HiBattery | MQTT through Home Assistant | Hoymiles MQTT setup |
| Indevolt SolidFlex and PowerFlex | Local HTTP API | Indevolt setup |
Omnibattery can coordinate supported brands in the same installation. Check the installation requirements before changing any manufacturer settings.
What it can do for you¶
-
Match battery power to home consumption
Reduce unwanted grid import or export as appliances turn on and off.
-
Make better use of solar energy
Combine live production, battery capacity and forecasts to decide when energy should be stored.
-
Charge when grid energy makes sense
Use time windows or electricity prices to buy only the energy your home is expected to need.
-
Coordinate several batteries
Share demand across compatible batteries while respecting each battery's charge, discharge and state-of-charge limits.
How to start¶
- Check the requirements and install Omnibattery.
- Add the integration and connect your grid sensor and battery.
- Open the Omnibattery sidebar panel to confirm power and state of charge, then enable only the features that suit your home.
Already using Marstek Venus Energy Manager? Follow the upgrade guide so your settings, entity history and dashboards remain connected.
Your control dashboard¶
The sidebar panel is installed with the integration; it does not require another Home Assistant Community Store (HACS) card or YAML dashboard configuration. Use Overview to follow live energy flow and daily history, Batteries to inspect each unit, and Control to enable and adjust optional features.

Advanced details
Omnibattery's proportional–derivative (PD) controller reacts when the grid sensor publishes a new value and adjusts battery power toward the configured grid target, including zero import or export. Tuning profiles from Very smooth to Very aggressive and the PD Control Quality sensor help identify a response that is stable, oscillating or slow. An optional direct-tracking mode follows the grid reading 1:1 in one control cycle, without integral, derivative, smoothing or rate-limit behavior.
The integration can coordinate up to ten batteries. It uses state-of-charge priorities, energy hysteresis and efficiency-aware sharing while applying per-battery and system power limits. See Multi-battery management.
The dashboard's Overview tab includes an animated state-of-charge ring, a Grid↔Home↔Battery↔Solar flow diagram, diagnostics, history charts and a measured/projected daily timeline. Batteries shows each unit's power, state of charge, health, cells, daily energy, optional maximum power point tracking (MPPT) inputs, firmware and controls.
Optional energy features include:
- Predictive charging using time slots, dynamic pricing or real-time prices, including Tibber; its demand estimate uses a seven-day rolling history of household consumption
- Time slots for independent charge and discharge windows, each with its own state-of-charge and power settings
- Capacity protection (peak shaving) to reserve energy for demand above a configured threshold
- Weekly full charge, which can charge to 100% for balancing, and a cell balance monitor that records cell-voltage spread and protects the open-circuit rest period
- Solar charge delay when expected production can fill the battery later
- Hourly net balance, which adjusts the PD target toward a configurable hourly grid-energy result and can use an external balance sensor
- Load exclusion for electric vehicle chargers and other large loads, with an individual exclusion setting from 0–100%
- Proactive Home Assistant fault and alarm notifications when a battery driver provides that telemetry; System Alarm Status summarizes the fleet as
OK,WarningorFault
State of charge (SOC) is the battery's remaining usable energy. The battery management system (BMS) applies the device's own cell and safety limits in addition to Omnibattery's software controls.
Disclaimer¶
Liability disclaimer
This software is provided "as is", without warranty of any kind. Use is at your own risk. The developer assumes no responsibility for damage to batteries, inverters, electrical installations, financial losses or personal injury.
If you do not agree to these terms, do not install or use this integration.
Support¶
If you find this integration useful, you can support the project: