tomwiggers/enphase-prometheus

A Direct to envoy metrics api for prometheus (currently in developement)

The Enphase Prometheus docker app (FORK)

This is an edited version of the application from which the consumption has been removed. It seemed to me the app expects an Envoy S metered and cannot deal with a standard version which does not provide consumption. This fork works with an Envoy S standard.

The image has also rebased on Debian Bookworm and built the image on amd64, which is available as ghcr.io/tomwiggers/enphase-prometheus:0.2.0 (sha256:92311e4ceb49f6b1671d44f486c5087cabd5d63ec2218947c7bfb70ea0014bcc).

Final note, I used the site ID instead of the site name for the env var ENPHASE_SITE. This can be taken from the URL in Enlighten.

Thanks to original creator of this app for their work!

getting the enlighten token for your envoy

Because the auth for enphase has been been changed to enlighten to tokens with only a 12 hour lifetime this docker application will do the following

• log into your enlighten account, then
• create a token, then
• use that token to authenticate with your envoy, then
• extract the data from the envoy and present it in a /metrics path

all of the actions above are cached for about 6 hours, so it wont spam enlighten with logins and token creations.

lastly and most importantly once a session is established with your envoy this will retreive data STRAIGHT FROM YOUR ENVOY, this means no ridiculous api fees form enlighten!

running the container

the container can be run like so, although I would suggest you store you token in a token file and run the environment with -e "ENPHASE_TOKEN=$(cat .tokenFile)" or with an environment file

docker run\
 -p 8000:8000\
 -e ENPHASE_HOST={ip_address_of_envoy}\
 -e ENPHASE_EMAIL={enlighted_email}\
 -e ENPHASE_PASSWORD={enlighten_password}\
 -e ENPHASE_SITE={enlighten_site_name}\
 -it mooseyman1988/enphase-prometheus

running in docker compose

version: "3.6"
services:
  enphase_prometheus:
    image: mooseyman1988/enphase-prometheus
    container_name: enphase_exporter
    ports:
      - 8000:8000
    environment:
      - ENPHASE_HOST={ip_address_of_envoy}
      - ENPHASE_EMAIL={enlighted_email}
      - ENPHASE_PASSWORD={enlighted_email}
      - ENPHASE_SITE={enlighten_site_name} #must be exact
      - ENPHASE_TIMEOUT=20 # optional seconds to timeout
    # or with an env file
    #env_file:
    #  - .enphase.env
    restart: unless-stopped