Sunplug Sign in

Setup guides → Home Assistant

Home Assistant

Already reading your solar in Home Assistant? A HACS integration sends the same readings to Sunplug — no extra hardware connection.

InstallVia HACS
NeedsHome Assistant 2026.3 or later, solar and grid power sensors in the Energy dashboard
How freshMatches your own sensors, at most every 30 seconds

Why use it

A device that only accepts one connection at a time — a SolarEdge inverter over Modbus TCP, a LuxPower dongle — can feed Sunplug too, once Home Assistant already holds that connection. Otherwise, the Sunplug Agent reading your equipment directly is still the more direct path.

Installing it

  1. In HACS, add a custom repository: https://github.com/sunplug/sunplug-homeassistant, category Integration
  2. Install it, then restart Home Assistant
  3. Settings → Devices & services → Add integration → Sunplug
  4. In the Sunplug app, Equipment → Home Assistant shows a pairing code — enter it here

The Energy dashboard

The integration reads the power sensors already configured in Home Assistant's own Energy dashboard — Settings → Dashboards → Energy. It needs a solar power sensor and a grid power sensor there; kWh totals alone are not enough. Battery power and battery charge are read too, if you have them.

There is no entity picker inside the integration itself. If it is reading the wrong sensor, fix the Energy dashboard rather than looking here.

Requires Home Assistant 2026.3 or later.

How often

A reading is sent whenever your sensors report a new value, at most every 30 seconds. The integration also tells Sunplug which Home Assistant integrations are behind those sensors.

How fresh that is

It depends on the Home Assistant integration behind your sensors. A local one — Modbus, MQTT, most inverter integrations — updates every few seconds to a minute, and works well here. A cloud one can be slower: SolarEdge's cloud integration updates every 15 minutes, Growatt's every 5. Victron's Remote Monitoring integration has no live data at all.

If yours is one of those, a local alternative usually exists: SolarEdge Modbus Multi or Growatt local, both on HACS, or a Victron GX read over Modbus or MQTT directly. Home Assistant raises a repair notice when a sensor Sunplug needs updates less often than every 5 minutes.

Signs

Nothing to configure. Home Assistant's Energy dashboard already uses Sunplug's own conventions: grid power positive when importing, battery power positive when discharging.

When it does not work

The grid arrow points the wrong way

If the flow to the grid runs backwards in Sunplug, the grid power sensor in Home Assistant's Energy settings has the wrong sign. Fix it there — Home Assistant offers an inverted option for exactly this — rather than in Sunplug.

A repair notice appears in Home Assistant

A sensor Sunplug needs is updating less often than every 5 minutes. See how fresh that is above for the usual cause and the local alternative.

Stuck? Write to me with the logs.