Sunplug Sign in

Setup guides → Enphase

Enphase

Read your Enphase system locally with the Sunplug Agent, or through the Enphase cloud with nothing at home.

With the Sunplug Agent

Every 30 seconds, day and night: production, grid, house load (with the consumption CTs, or a Shelly at the supply point) and battery.

  1. Set up the Sunplug Agent on your home network
  2. Its setup page finds the IQ Gateway (an Envoy, on older systems) and reads its serial
  3. Enter your Enlighten login once: the agent trades it for a token scoped to your gateway, valid about a year. The password never leaves your network

Through the Enphase cloud

Nothing at home. Live once a second while a car charges on sun, a quarter-hour average otherwise. House load needs the consumption CTs.

  1. In the app, open Settings, pick Enphase and choose the cloud route
  2. Tap Open the Enphase app and approve Sunplug's access to your system
  3. Come back to Sunplug. It finds your system by your Enphase account's email, usually within seconds. If your Enphase account uses a different address, Sunplug asks for it after a minute and a half

You can withdraw access in the Enphase app at any time. While the agent is sending readings, the cloud is not used, and switching loses no history.

Checking it works

The agent's page shows a fresh reading every thirty seconds — production, grid, house load and battery. In the app, the dashboard's freshness indicator should settle to a few seconds.

When it does not work

Nothing found on the network

The agent's machine is probably on a different network segment, such as guest Wi-Fi or an IoT VLAN. Enter the gateway's address in the field under the list of what the setup page found.

The gateway rejects the token

The agent renews tokens a month before expiry, and re-mints one if it is rejected sooner. Repeated failures usually mean the Enlighten password changed.

House consumption looks wrong, or is missing

Consumption needs CT clamps around your supply; many Enphase installs monitor production only. Without them, pair a Shelly meter at the supply point.

Charging never starts on a sunny day

Almost always the grid sign: export must be negative. If the dashboard's flow diagram shows power going the wrong way between house and grid, fix that first.

Stuck? Email me with the log output.