About
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
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.
Provides
- Switches
- Sensors
- Weather
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Enphase Energy
- EmailYour Enlighten account email.
- PasswordPassword is only stored if you enable the checkbox.
- Store password for automatic reauthenticationAllows the integration to refresh tokens automatically when they expire.
Verify MFA Code
- One-time codeUse the code from the Enphase login prompt.
- Resend codeRequest a new code if the previous one expired.
Select Site
- Site
Select Devices
- GatewayIncludes gateway connectivity and meter diagnostics.
- BatteryIncludes battery status and control entities when available.
- EV ChargersIncludes EV charger entities and controls.
- Heat PumpIncludes heat pump status, diagnostics, and usage sensors.
- MicroinvertersIncludes microinverter connectivity, active count, and lifetime production sensors.
- Scan interval (s)Seconds between cloud status polls. Default 60s.
After setup
- GatewayIncludes gateway connectivity and meter diagnostics.
- BatteryIncludes battery status and control entities when available.
- EV ChargersIncludes EV charger entities and controls.
- Heat PumpIncludes heat pump status, diagnostics, and usage sensors.
- MicroinvertersIncludes 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 ActiveUse 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 RepairsCreate Home Assistant Repairs issues when optional Enphase cloud services are degraded. Default: Disabled.
- Enable WeatherFetch 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 ActiveUse 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 RepairsCreate Home Assistant Repairs issues when optional Enphase cloud services are degraded. Default: Disabled.
- Devices
- GatewayIncludes gateway connectivity and meter diagnostics.
- BatteryIncludes battery status and control entities when available.
- EV ChargersIncludes EV charger entities and controls.
- Heat PumpIncludes heat pump status, diagnostics, and usage sensors.
- MicroinvertersIncludes microinverter connectivity, active count, and lifetime production sensors.
- GatewayIncludes gateway connectivity and meter diagnostics.
- BatteryIncludes battery status and control entities when available.
- EV ChargersIncludes EV charger entities and controls.
- Heat PumpIncludes heat pump status, diagnostics, and usage sensors.
- MicroinvertersIncludes microinverter connectivity, active count, and lifetime production sensors.
- Enable Degraded Service RepairsCreate Home Assistant Repairs issues when optional Enphase cloud services are degraded. Default: Disabled.
- Enable System Event Repair NotificationsCreate Home Assistant Repairs issues for active system alarms reported by Enphase. Default: Disabled.
- Enable Descriptive Activity EntriesAdd descriptive entries to Home Assistant Activity when reported conditions change. These appear alongside normal state-change entries. Disabled by default.
- Start ReauthenticationStart the login flow to refresh credentials without removing the integration. This is a one-time action when submitted.
- Forget Stored PasswordDelete 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 productionAssign a cumulative production total to the Enphase Energy Site Solar Production sensor. Do not choose daily energy or live power.
- ConsumptionAssign a cumulative consumption total to the Enphase Energy Site Consumption sensor. Do not choose daily energy or live power.
- Grid importAssign a cumulative grid import total to the Enphase Energy Site Grid Import sensor. Do not choose daily energy or live power.
- Grid exportAssign a cumulative grid export total to the Enphase Energy Site Grid Export sensor. Do not choose daily energy or live power.
- Battery chargeAssign a cumulative battery charge total to the Enphase Energy Site Battery Charge sensor. Do not choose daily energy or live power.
- Battery dischargeAssign 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.
Entities
- Binary sensorsVehicle Connection, Charging, Heat Pump SG-Ready Active, Cloud Reachable, Connectivity, System Events
- ButtonsStorm 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
- CalendarsBackup History, System Event History, VPP Events
- NumbersBattery 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
- SelectsSystem Profile, Charge Mode, Battery Schedule, Battery Schedule Type, Schedule, Export Limit
- SensorsLast Session, Connector Status, Connector Reason, Electrical Phase, Power, Charge Mode, Charger Authentication, Storm Guard, and 88 more
- SwitchesCharging, 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
- TimesCharge 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
- UpdatesGateway Firmware, Firmware
- WeatherWeather
Actions
- Start ChargingStart charging on the selected Enphase Energy charger.Fields: Charging level (A), Connector ID
- Stop ChargingStop charging on the selected Enphase Energy charger.
- Trigger OCPP MessageRequest the charger to send an OCPP message and return the cloud response.Fields: Requested message, Confirm advanced trigger, Site ID
- Clear Reauth IssueSelect an Enphase site device to clear its reauthentication repair issue.Fields: Chargers, Site ID
- Start Live StreamRequest faster cloud status updates for a short period.Fields: Site ID
- Stop Live StreamStop the cloud live stream request.Fields: Site ID
- Sync SchedulesRefresh Enphase schedules from the cloud.Fields: Chargers
- Request Grid Toggle OTPSend the one-time code required before changing site grid mode.Fields: Enphase config entry
- Set Grid ModeChange site grid mode after validating the one-time code.Fields: Grid mode, One-time code, Enphase config entry
- Update CFG ScheduleUpdate 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 RefreshRefresh battery schedule data from the Enphase cloud immediately.Fields: Site ID, Config Entry ID
- Add Battery ScheduleCreate 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 ScheduleUpdate 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 ScheduleDelete one or more battery schedules by schedule ID.Fields: Schedule ID, Schedule IDs, Confirm, Site ID, Config Entry ID
- Validate Battery ScheduleCheck whether battery schedule editing is available for the selected schedule family.Fields: Schedule Type, Site ID, Config Entry ID
- Try Reauth NowUse stored Enphase credentials to attempt reauthentication immediately for the selected site.Fields: Site devices, Site ID
- Update TariffUpdate 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 BackoffClear the temporary HEMS/Heat Pump auth backoff without performing password login.Fields: Site devices, Site ID
- Browse Grid ProfilesBrowse 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 ProfilesForce 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
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- System healthAdds its status to Home Assistant's system information.
- Repair noticesNotices 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
Shows in Vulpo
Quick Toggle card, Button card, Select card, Calendar card, Lumen sky, Apple Watch, Control Center.Information
- Installs
- 406 sharing analytics
- GitHub stars
- 38
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v5.2.2,
- Category
- Energy, Solar and batteries
- Kind
- Marketplace integration
- Brand
- Enphase
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
enphase_ev- Issues
- Report an issue
