Skip to content

Installation and Setup

Jump to bottom
Varitras edited this page Oct 22, 2026 · 2 revisions

Installation and Setup

Requires Home Assistant 2026.9.0 or newer.

Install

HACS (recommended)

  1. HACS → ⋮ → Custom repositories.
  2. Repository https://github.com/Varitras/ha-wattpilot, type Integration.
  3. Install Fronius Wattpilot, then restart Home Assistant.

Pre-releases (betas): HACS offers them once the repository's Pre-release switch entity is enabled (it is disabled by default) and turned on.

Manual

Copy custom_components/wattpilot/ into your Home Assistant config/custom_components/ directory and restart.

Connect the charger

Home Assistant finds the charger on your network by itself (mDNS) and offers it under Settings → Devices & Services as discovered; only the password is left to enter. Discovery uses the charger's IPv4 address.

To add it by hand: Settings → Devices & Services → Add Integration → Fronius Wattpilot.

  • Host: the charger's IPv4 address or host name. An IPv6 address goes in brackets, but works only if the charger has a routable one.
  • Password: the charger password you use in the Wattpilot.Solar app, not your Wi-Fi or Fronius account password.

New installations name the device Wattpilot, so entity IDs read like sensor.wattpilot_total_energy; a second charger becomes Wattpilot 2.

When the charger moves or the password changes

  • New address: when the entry has lost its charger and the charger announces itself at a new address, the entry takes it and reloads. An entry that is still connected ignores announcements elsewhere, an entry set up by host name keeps the name, and an entry whose setup failed takes a new address and reloads as well. A DHCP reservation still does no harm.
  • Moved without announcing itself: use Reconfigure on the entry instead of deleting and re-adding it; that keeps the history. It asks for the address and the password again.
  • Password rejected: Home Assistant starts a re-authentication flow on its own.

Options

Configure on the entry offers one setting:

Option Default Range
Update interval (seconds) 5 0 to 60

Update interval coalesces the charger's pushes: at most one update per entity per interval. 0 forwards every change immediately. This is not a polling interval, see How Data Updates.

Everything is configured through the UI; there is nothing to put in configuration.yaml.

Remove

Settings → Devices & Services → Fronius Wattpilot → ⋮ → Delete removes the entry, its device and all its entities. If you installed via HACS, remove it there too and restart. The integration stores nothing on the charger, but settings changed through it stay; if you turned on the go-e cloud API with wattpilot.set_goe_cloud, turn it off first.

Clone this wiki locally