--- title: "Enphase Envoy" description: "Enphase Envoy is a built-in integration for Home Assistant. It has 10.8k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/enphase-envoy" url: "https://vulpo.app/integrations/core/enphase-envoy.md" last-updated: "2026-10-22" version: "1.4" --- # Enphase Envoy > Enphase Envoy is a built-in integration for Home Assistant. It has 10.8k installs sharing analytics and works locally. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=enphase_envoy) ## 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. ## 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 - **Host**: The hostname or IP address of your Enphase Envoy gateway. - **Password**: Blank or Enphase Cloud password - **Envoy access token** - **Enter the Envoy access token manually**: If your Enphase Cloud account has multi-factor authentication enabled, check this option to add or update your token manually. - **Username**: Installer or Enphase Cloud username Also asked when changing the connection. ### Sign in again - **Password**: Blank or Enphase Cloud password - **Envoy access token** - **Enter the Envoy access token manually**: If your Enphase Cloud account has multi-factor authentication enabled, check this option to add or update your token manually. - **Username**: Installer 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](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Binary sensors**: Communicating, DC switch, Grid status, Operating, Producing - **Buttons**: Sleep, Wake - **Numbers**: Cutoff battery level, Reserve battery level, Restore battery level - **Selects**: Battery sleep SOC target, Generator action, Grid action, Microgrid action, Mode, Storage mode - **Sensors**: AC 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 - **Switches**: Charge from grid, Grid enabled ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## At a glance - Kind: Built-in integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Brand: [Enphase](https://vulpo.app/integrations/enphase.md) - Number: 10.8k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Platinum quality scale - Domain: `enphase_envoy` - Source: In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center ## Other ways in for Enphase | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Enphase Envoy (Installer)](https://vulpo.app/integrations/marketplace/vincentwolsink-home-assistant-enphase-envoy-installer.md) | Marketplace integration | 1.1k installs sharing analytics | Works locally | Updated in the last 6 months | | [Enphase Energy](https://vulpo.app/integrations/marketplace/barneyonline-ha-enphase-energy.md) | Marketplace integration | 406 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/enphase-envoy --- - HTML version of this page: https://vulpo.app/integrations/core/enphase-envoy - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml