About
Enphase Envoy is a built-in integration that connects Home Assistant to an Enphase Envoy gateway over the local network. It adds binary sensors, buttons, numbers, selects, sensors and switches covering solar production, grid status and battery storage. Battery controls include reserve and cutoff levels, storage mode, sleep and wake buttons, and a switch for charging from the grid. Home Assistant can find the gateway on the network and offer to add it, and setup runs in the UI with a host, username and password or an access token. New devices appear without repeating setup, and devices that are gone are removed on their own. Options allow a fresh connection for each request and adding fixture data to the diagnostics file.
Automatic summary of Home Assistant's source code. Something wrong? Get in touch
Supports
Works locally Talks to your devices on your own network. No vendor cloud in between.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Found by itself Home Assistant spots it on the network and offers to add it.
Adds new devices New devices show up without setting it up again.
Cleans up devices Devices that are gone are removed by themselves.
Change settings later Its connection settings can change without removing it.
Platinum quality Home Assistant's own rating of its code and setup experience.
Updated with Home Assistant Ships and updates with every Home Assistant release.
Provides
- Switches
- Sensors
Setting it up
Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services.
Connect
- HostThe hostname or IP address of your Enphase Envoy gateway.
- PasswordBlank or Enphase Cloud password
- Envoy access token
- Enter the Envoy access token manuallyIf your Enphase Cloud account has multi-factor authentication enabled, check this option to add or update your token manually.
- UsernameInstaller or Enphase Cloud username
Also asked when changing the connection.
Sign in again
- PasswordBlank or Enphase Cloud password
- Envoy access token
- Enter the Envoy access token manuallyIf your Enphase Cloud account has multi-factor authentication enabled, check this option to add or update your token manually.
- UsernameInstaller or Enphase Cloud username
After setup
- Include test fixture data in diagnostic report. Use when requested to provide test data for troubleshooting or development activities. With this option enabled the diagnostic report may take more time to download. When report is created best disable this option again.Include fixtures in diagnostics report
- Always use a new connection when requesting data from the Envoy. May resolve communication issues with some Envoy firmwares.May resolve communication issues with some Envoy firmwares.
Texts from Home Assistant's source code, Apache License 2.0.
Entities
- Binary sensorsCommunicating, DC switch, Grid status, Operating, Producing
- ButtonsSleep, Wake
- NumbersCutoff battery level, Reserve battery level, Restore battery level
- SelectsBattery sleep SOC target, Generator action, Grid action, Microgrid action, Mode, Storage mode
- SensorsAC current, AC voltage, Sleep state, Available ACB battery energy, Charge status, Sleep SOC target, State of charge, Battery state, ACB Battery capacity, Admin state, Aggregated available battery energy, Aggregated Battery capacity, and 96 more
- SwitchesCharge from grid, Grid enabled
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.












