--- title: "Enphase Energy" description: "Enphase Energy is a Marketplace integration for Home Assistant. It has 406 installs sharing analytics, needs the vendor's cloud and was last updated October 27, 2026." canonical: "https://vulpo.app/integrations/marketplace/barneyonline-ha-enphase-energy" url: "https://vulpo.app/integrations/marketplace/barneyonline-ha-enphase-energy.md" last-updated: "2026-10-26" version: "1.4" --- # Enphase Energy > Enphase Energy is a Marketplace integration for Home Assistant. It has 406 installs sharing analytics, needs the vendor's cloud and was last updated October 27, 2026. Enphase Energy is a cloud-based integration that connects Enphase solar, battery and EV charger systems to Home Assistant. It covers the gateway, batteries, EV chargers, heat pumps and microinverters, and each category can be switched on or off during setup and later in the options. Site and battery energy readings are meant for the Energy Dashboard, and a tool is included to carry over history from the core Enphase Envoy integration. Controls include EV charging, battery reserve levels, battery schedules, Storm Guard, grid mode changes confirmed by a one-time code, and editable tariffs. Optional extras are site weather, system event calendars, repair notices for cloud problems, and device triggers for charging started, stopped, plugged in and unplugged. Setup happens in the UI with an Enlighten account sign-in that supports multi-factor codes, and polling intervals are adjustable. Automatic summary of the README and code of barneyonline/ha-enphase-energy. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=barneyonline&repository=ha-enphase-energy&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=barneyonline&repository=ha-enphase-energy&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **Device triggers**: Its devices can start automations directly. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Enphase Energy - **Email**: Your Enlighten account email. - **Password**: Password is only stored if you enable the checkbox. - **Store password for automatic reauthentication**: Allows the integration to refresh tokens automatically when they expire. ### Verify MFA Code - **One-time code**: Use the code from the Enphase login prompt. - **Resend code**: Request a new code if the previous one expired. ### Select Site - **Site** ### Select Devices - **Gateway**: Includes gateway connectivity and meter diagnostics. - **Battery**: Includes battery status and control entities when available. - **EV Chargers**: Includes EV charger entities and controls. - **Heat Pump**: Includes heat pump status, diagnostics, and usage sensors. - **Microinverters**: Includes microinverter connectivity, active count, and lifetime production sensors. - **Scan interval (s)**: Seconds between cloud status polls. Default 60s. ### After setup - **Gateway**: Includes gateway connectivity and meter diagnostics. - **Battery**: Includes battery status and control entities when available. - **EV Chargers**: Includes EV charger entities and controls. - **Heat Pump**: Includes heat pump status, diagnostics, and usage sensors. - **Microinverters**: Includes microinverter connectivity, active count, and lifetime production sensors. - **Fast Poll Interval (s)**: Time between updates while charging or using fast cloud-stream polling. Default: 30 s. - **Slow Poll Interval (s)**: Time between updates when chargers are idle and fast cloud-stream polling is inactive. Default: 60 s. - **Prefer Fast Polling While Cloud Stream Active**: Use the fast polling interval while an Enphase cloud stream is active, even when chargers are idle. Default: Enabled. - **API Timeout (s)**: Maximum time to wait for an Enphase API request before it times out. Default: 15 s. - **EV Charger Nominal Voltage (V)**: AC supply voltage used to estimate charger power when live voltage is unavailable. Default: Learned from charger telemetry when available; otherwise based on the Home Assistant region, with a 230 V fallback. - **Session History Interval (min)**: Minimum time between cloud charging-session history requests. Default: 10 min. - **Enable EV Charger Scheduler** - **Enable Battery Scheduler** - **Enable Degraded Service Repairs**: Create Home Assistant Repairs issues when optional Enphase cloud services are degraded. Default: Disabled. - **Enable Weather**: Fetch site weather from Enphase and create a weather entity when the service is available. Default: Disabled. - **Fast Poll Interval (s)**: Time between updates while charging or using fast cloud-stream polling. Default: 30 s. - **Slow Poll Interval (s)**: Time between updates when chargers are idle and fast cloud-stream polling is inactive. Default: 60 s. - **Prefer Fast Polling While Cloud Stream Active**: Use the fast polling interval while an Enphase cloud stream is active, even when chargers are idle. Default: Enabled. - **API Timeout (s)**: Maximum time to wait for an Enphase API request before it times out. Default: 15 s. - **Session History Interval (min)**: Minimum time between cloud charging-session history requests. Default: 10 min. - **Enable Degraded Service Repairs**: Create Home Assistant Repairs issues when optional Enphase cloud services are degraded. Default: Disabled. - **Devices** - **Gateway**: Includes gateway connectivity and meter diagnostics. - **Battery**: Includes battery status and control entities when available. - **EV Chargers**: Includes EV charger entities and controls. - **Heat Pump**: Includes heat pump status, diagnostics, and usage sensors. - **Microinverters**: Includes microinverter connectivity, active count, and lifetime production sensors. - **Gateway**: Includes gateway connectivity and meter diagnostics. - **Battery**: Includes battery status and control entities when available. - **EV Chargers**: Includes EV charger entities and controls. - **Heat Pump**: Includes heat pump status, diagnostics, and usage sensors. - **Microinverters**: Includes microinverter connectivity, active count, and lifetime production sensors. - **Enable Degraded Service Repairs**: Create Home Assistant Repairs issues when optional Enphase cloud services are degraded. Default: Disabled. - **Enable System Event Repair Notifications**: Create Home Assistant Repairs issues for active system alarms reported by Enphase. Default: Disabled. - **Enable Descriptive Activity Entries**: Add descriptive entries to Home Assistant Activity when reported conditions change. These appear alongside normal state-change entries. Disabled by default. - **Start Reauthentication**: Start the login flow to refresh credentials without removing the integration. This is a one-time action when submitted. - **Forget Stored Password**: Delete the saved password and stop automatic password-based credential refresh. This is a one-time action when submitted. - **Envoy source** - **I have a recent Home Assistant backup** - **Solar production**: Assign a cumulative production total to the Enphase Energy Site Solar Production sensor. Do not choose daily energy or live power. - **Consumption**: Assign a cumulative consumption total to the Enphase Energy Site Consumption sensor. Do not choose daily energy or live power. - **Grid import**: Assign a cumulative grid import total to the Enphase Energy Site Grid Import sensor. Do not choose daily energy or live power. - **Grid export**: Assign a cumulative grid export total to the Enphase Energy Site Grid Export sensor. Do not choose daily energy or live power. - **Battery charge**: Assign a cumulative battery charge total to the Enphase Energy Site Battery Charge sensor. Do not choose daily energy or live power. - **Battery discharge**: Assign a cumulative battery discharge total to the Enphase Energy Site Battery Discharge sensor. Do not choose daily energy or live power. Texts from the code of [barneyonline/ha-enphase-energy](https://github.com/barneyonline/ha-enphase-energy). ## Entities - **Binary sensors**: Vehicle Connection, Charging, Heat Pump SG-Ready Active, Cloud Reachable, Connectivity, System Events - **Buttons**: Storm Alert Opt Out, Battery Schedule Refresh, Battery Schedule Save, Battery Schedule Delete, Battery Schedule Add, Schedule Refresh, Schedule Save, Schedule Delete, Create new schedule, and 1 more - **Calendars**: Backup History, System Event History, VPP Events - **Numbers**: Battery Reserve, Battery Shutdown Level, Battery Charge Limit, Charging Amps, Default Charge Level, Discharge To Grid Limit, Restrict Battery Discharge Limit, Battery Schedule Limit, Battery New Schedule Limit, and 1 more - **Selects**: System Profile, Charge Mode, Battery Schedule, Battery Schedule Type, Schedule, Export Limit - **Sensors**: Last Session, Connector Status, Connector Reason, Electrical Phase, Power, Charge Mode, Charger Authentication, Storm Guard, and 88 more - **Switches**: Charging, Use Battery for EV Charging, Auth via App, Storm Guard, Charge Battery From Grid, PowerMatch, Charge From Grid Schedule, Use Battery After Peak Hours, and 24 more - **Times**: Charge From Grid Start Time, Charge From Grid End Time, Discharge To Grid Start Time, Discharge To Grid End Time, Restrict Battery Discharge Start Time, Restrict Battery Discharge End Time, Battery Schedule Start Time, Battery Schedule End Time, and 4 more - **Updates**: Gateway Firmware, Firmware - **Weather**: Weather ## Actions - **Start Charging**: Start charging on the selected Enphase Energy charger. Fields: Charging level (A), Connector ID - **Stop Charging**: Stop charging on the selected Enphase Energy charger. - **Trigger OCPP Message**: Request the charger to send an OCPP message and return the cloud response. Fields: Requested message, Confirm advanced trigger, Site ID - **Clear Reauth Issue**: Select an Enphase site device to clear its reauthentication repair issue. Fields: Chargers, Site ID - **Start Live Stream**: Request faster cloud status updates for a short period. Fields: Site ID - **Stop Live Stream**: Stop the cloud live stream request. Fields: Site ID - **Sync Schedules**: Refresh Enphase schedules from the cloud. Fields: Chargers - **Request Grid Toggle OTP**: Send the one-time code required before changing site grid mode. Fields: Enphase config entry - **Set Grid Mode**: Change site grid mode after validating the one-time code. Fields: Grid mode, One-time code, Enphase config entry - **Update CFG Schedule**: Update the charge-from-grid schedule start time, end time, and/or charge limit in a single atomic operation. Fields: Start Time, End Time, Charge Limit, Site ID - **Force Refresh**: Refresh battery schedule data from the Enphase cloud immediately. Fields: Site ID, Config Entry ID - **Add Battery Schedule**: Create a battery schedule for CFG, DTG, or RBD. Fields: Schedule Type, Start Time, End Time, Charge Limit, Days, Site ID, Config Entry ID - **Update Battery Schedule**: Update a battery schedule by schedule ID. Fields: Schedule ID, Schedule Type, Start Time, End Time, Charge Limit, Days, Confirm, Site ID, Config Entry ID - **Delete Battery Schedule**: Delete one or more battery schedules by schedule ID. Fields: Schedule ID, Schedule IDs, Confirm, Site ID, Config Entry ID - **Validate Battery Schedule**: Check whether battery schedule editing is available for the selected schedule family. Fields: Schedule Type, Site ID, Config Entry ID - **Try Reauth Now**: Use stored Enphase credentials to attempt reauthentication immediately for the selected site. Fields: Site devices, Site ID - **Update Tariff**: Update Enphase billing-cycle details, guided tariff structures, and one or more existing import or export tariff rate values. Fields: Rate, Rate Entity, Import Rate, Import Rate Entity, Export Rate, Export Rate Entity, Billing Start Date, Billing Frequency, Billing Interval, Rates - **Clear HEMS Auth Backoff**: Clear the temporary HEMS/Heat Pump auth backoff without performing password login. Fields: Site devices, Site ID - **Browse Grid Profiles**: Browse cloud Activation grid profiles available for the selected site country and region. Fields: Region code, Search, Commonly used only, Site devices, Site ID, Config entry ID - **Refresh Grid Profiles**: Force refresh cloud Activation grid profile reference data and the selected region catalog. Fields: Region code, Commonly used only, Site devices, Site ID, Config entry ID ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **System health**: Adds its status to Home Assistant's system information. - **Repair notices**: Notices it can show in Settings, Repairs: Enphase Energy needs reauthentication, Enphase Energy authentication temporarily blocked, Enphase Energy has too many active sessions, Enphase Energy is rate limited, Enphase Energy cloud unreachable, Enphase Energy DNS resolution failure, Enphase Energy cloud errors, Enphase Energy scheduler unavailable, Enphase Energy session history unavailable, Enphase Energy site energy unavailable, Enphase Energy authentication settings unavailable, Enphase Energy battery profile update pending, Enphase Energy HEMS temporarily paused, High-impact Enphase system event active, Export Limit update unconfirmed ## From the README > Cloud-based Home Assistant integration for Enphase Energy systems. > > - Guided setup with site, device-category, and multi-gateway selection > - Site and battery energy monitoring for the Home Assistant Energy Dashboard > - EV charging controls, actual charging status, and session history > - Battery profiles, reserve settings, schedules, and supported PowerMatch controls > - Array monitoring and optional per-microinverter energy and power sensors > - Heat-pump status, SG-Ready mode, and energy monitoring > - Gateway and charger firmware information with release-note links > - Editable tariffs, optional installer Grid Profile controls, and OTP-confirmed Grid Mode changes > - Storm Alert controls and guided battery profile recovery through Repairs > - System events, alarms, and calendars, plus optional VPP/ELRP monitoring > - Optional site weather from Enphase > - Cloud recovery, health diagnostics, and automation actions From the README of [barneyonline/ha-enphase-energy](https://github.com/barneyonline/ha-enphase-energy#readme), [GNU GPL v3.0](https://spdx.org/licenses/GPL-3.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Brand: [Enphase](https://vulpo.app/integrations/enphase.md) - Number: 406 installs sharing analytics; 38 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v5.2.2, last updated October 27, 2026 - Domain: `enphase_ev` - Source: - Issues: In Vulpo: Quick Toggle card, Button card, Select card, Calendar card, Lumen sky (Pro), Apple Watch, Control Center ## Other ways in for Enphase | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Enphase Envoy](https://vulpo.app/integrations/core/enphase-envoy.md) | Built-in integration | 10.8k installs sharing analytics | Works locally | Part of Home Assistant | | [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 | 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-26. Source: https://vulpo.app/integrations/marketplace/barneyonline-ha-enphase-energy --- - HTML version of this page: https://vulpo.app/integrations/marketplace/barneyonline-ha-enphase-energy - 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