Enphase Envoy
enphase_envoy
The Enphase Envoy integration is used to integrate with the Enphase IQ Gateway, a communication device for Enphase solar inverters and batteries. In this documentation, as well as in integration entity names, the Enphase IQ Gateway is commonly referred to as Envoy, a name from the conception times of this integration and retained for its compact format.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
Local polling works with Envoy-R, Envoy-S and IQ Combiner; firmware 7+ needs token auth and firmware 8.2.4225+ makes battery controls read-only.
- Works5
- Partly works1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Enphase ACB batteries | Works Local | ACB battery data added Nov 2024Saved copyProposed change The Enphase Envoy integration has long time support for Encharge batteries. For installations with additional, older type, ACB batteries, no ACB Battery data, nor aggregated data for all batteries is currently made avaialble. This PR adds support for ACB batteries whe Excerpt saved from GitHub on 2026-10-23. | PR #131298 · 2024-11 | |
| Enphase Envoy firmware D7.0.88 | Works Local | Token auth broke it in early 2023; closed completedSaved copyDo you know what the latest version of firmware is for Enphase? Looking at the Enphase forums the software updates are automatically pushed by Enphase. Mine is version 7.3On Jun 20, 2023, at 12:59 AM, Daniel *@*.*> wrote: The Enphase integration is no longer working on my HA instance as well. The integration is not able to authenticate with Enphase. See screenshot: . you have proberbly upgrade the firmware of your gateway? The firmware from7.xx does not work anymore with the current intergration of HA., Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this … Excerpt saved from GitHub on 2026-10-23. | Issue #86781 · 2023-01 | |
| Enphase Envoy-R / Envoy-S (not metered) | Works Local | Production metrics onlySaved copySupported devices: Older and newer Envoy models that only have production metrics (such as Envoy-R (LCD), Envoy-S (not metered)); Newer Envoy models that offer both production and consumption metrics (such as Envoy-S Metered equipped with CT).; Various Enphase IQ Combiner products that have an embedded Envoy, it will show-up in the same way as the stand-alone one.. Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| Enphase Envoy-S Metered / IQ Combiner | Works Local | Production and consumption metrics supportedSaved copySupported devices: Older and newer Envoy models that only have production metrics (such as Envoy-R (LCD), Envoy-S (not metered)); Newer Envoy models that offer both production and consumption metrics (such as Envoy-S Metered equipped with CT).; Various Enphase IQ Combiner products that have an embedded Envoy, it will show-up in the same way as the stand-alone one.. Excerpt saved from home-assistant.io on 2026-10-23. | Docs | |
| Enphase Envoy-S-Standard-EU firmware D5.055 | Works Local | Works fine on 2023.2 betaSaved copyI'm running 2023.2.0b4 and the Envoy integration works fine. However I didn't not remove it and try to set it up again. Envoy firmware: D5.055 (Envoy-S-Standard-EU) Excerpt saved from GitHub on 2026-10-23. | Issue #86781 · 2023-01 | |
| Enphase IQ Battery 5P with IQ System Controller 3 (firmware D8.3.5226) | Partly works Local | Battery controls exposed but read-only on new firmwareSaved copyEnvoy firmware version: D8.3.5226 Enphase equipment: - IQ System Controller 3 INT - Envoy (integrated inside System Controller) - 24 × IQ7+ microinverters - 2 × IQ 5P battery - Location: Queensland, Australia Diagnostics: Attached above. Excerpt saved from GitHub on 2026-10-23. | Issue #183032 · 2026-09 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 10,771 (1.52%) |
|---|---|
| Quality scale | Platinum |
| Added in | Home Assistant 0.76 |
| Set up in the UI | Yes |
| Maintainers | @bdraco, @cgarwood, @catsmanac |
Devices listed in its documentation
- Older and newer Envoy models that only have production metrics (such as Envoy-R (LCD), Envoy-S (not metered))
- Newer Envoy models that offer both production and consumption metrics (such as Envoy-S Metered equipped with CT).
- Various Enphase IQ Combiner products that have an embedded Envoy, it will show-up in the same way as the stand-alone one.
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
