Installation
You install the integration once, then add each battery. Check the requirements below first if you haven't yet.
HACS (recommended)
HACS is the community store for Home Assistant. Installing through it means Home Assistant tells you when a new version is out. This integration is not in the HACS default list yet, so you add it once as a custom repository.
- Open HACS in Home Assistant.
- Open the three-dot menu > Custom repositories. Paste
https://github.com/taurgis/has-marstek-local-apiand choose Integration as the type. - Search for Marstek and install.
- Restart Home Assistant.
Manual
Use this only if you don't run HACS. You will have to repeat it by hand for every update.
- Download the
custom_components/marstekfolder from the GitHub repository. - Copy it into your Home Assistant config folder (the folder that holds
configuration.yaml), so it ends up atconfig/custom_components/marstek. - Restart Home Assistant.
Requirements checklist
- Home Assistant Core 2025.10 or newer.
- Open API turned on in the Marstek app. The Open API is the local interface the integration talks to. It is off by default.
- Home Assistant can reach the battery over your network on the Open API port, 30000 unless you changed it in the Marstek app. The integration uses UDP on that port.
- For automatic discovery, the battery and Home Assistant are on the same network. If the battery sits on a separate VLAN, add it by IP address and allow UDP traffic on its port in your router or firewall.
- A Venus E 2.0 can be added. Support is experimental: polling can still disconnect it from its CT003 meter, and Home Assistant shows a repair warning.
Next
Add the battery in Configuration, then follow the visual tour for the Battery health dashboard, the cards, and a linked smart plug.