Enphase Envoy
homebridge-enphase-envoy · v10.8.1
Adds Enphase Envoy solar, battery and meter data to HomeKit.
What it says it supports
Brands
- Enphase
Devices it names
- Envoy S
- IQ Gateway
- IQ Combiner
- Q-Relay
- AC Battery
- IQ Battery 3/10/5P
- M215
- IQ6/IQ7/IQ8 microinverters
- Communications Kit
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Reads Enphase Envoy solar data including firmware 7.x via token; Home app shows it as unsupported because of custom characteristics, so Eve or Controller app is needed. Battery profile control was added later.
- Works2
- Partly works2
| Device | Status | What they said | Source |
|---|---|---|---|
| Enphase Envoy (firmware 7.x) | Works | Supported with token auth since v6; early PLC level error was reported then handledSaved copy… "provisioned": true, "operating": false }, { "part_num": "800-01127-r02", "installed": "1662981639", "serial_num": "482229010903", "device_status": [ "envoy.cond_flags.pcu_ctrl.dc-pwr-low" ], "last_rpt_date": "1673281355", "admin_state": 2, "dev_type": 1, "created_date": "1662981639", "img_load_date": "1613405094", "img_pnum_running": "520-00082-r01-v04.27.04", "ptpn": "540-00169-r01-v04.27.09", "chaneid": 1627391249, "device_control": [ { "gficlearset": false } ], "producing": true, "communicating": true, "provisioned": true, "operating": true }, { "part_num": "800-01127-r02", "installed": … Excerpt saved from GitHub on 2026-10-22. | Issue #69 · 2023-01 |
| Enphase Envoy D8.3.4041 | Works | Token validation succeeded after updating to Homebridge 2 betaSaved copyHi! Went to https://entrez.enphaseenergy.com/, logged in, selected my site, got a token. Copied and pasted it into the Enphase Envoy homebridge config. Got the following error, verbose on: [code] Here is my JSON: [code] Excerpt saved from GitHub on 2026-10-22. | Issue #227 · 2026-03 |
| Enphase Encharge battery | Partly works | Profile control added in 10.2.0 beta; earlier not controllable from automationsSaved copyChanges fix encharge profile control UI interface fix #205 fix #206 fix #207 fix #209 fix #211 workaround for #210, envoy firmware issue prepare to add encharge profile controls option to allow charge from grid added configurable system auto lock time added EVE energy monitor option (need to be paired as a separate accessory) added support for EVSE, PV3P, BackFeed meters added support for C6 Combiner Controller, C6 RGM, IQ Meter Collar refactor code of ensemble section stability and improvements config UI updated bump dependencies redme updated cleanup Excerpt saved from GitHub on 2026-10-22. | PR #212 · 2025-10 |
| Enphase Envoy live data meters | Partly works | Live data stops changing unless opened in Enphase app; values come from EnvoySaved copyHello, first of all: BIG THANK YOU for this plugin, the best solution to integrate Enphase in a SmartHome I found! I have one problem: The plugin works and is reporting all kind of data on MQTT but the "live data" is only updated when I open live data in the app (or via web login) for some time and then it stops. To be precise: It is still updated every 5 sec as per my settings but with no change in values. My setup is as follows (from homebridge.log): `^[[37m[2/14/2023, 10:48:53 AM] ^[[39mHomebridge v1.6.0 (HAP v0.11.0) (Homebridge AD15) is running on port 51986. ^[[37m[2/14/2023, 10:48:54 … Excerpt saved from GitHub on 2026-10-22. | Issue #80 · 2023-02 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Envoy LAN API; optional Enlighten login for tokens; MQTT and REST
You’ll need
- Enphase Envoy
- Enlighten credentials for firmware 7+
- Homebridge 2.0
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20 || ^22 || ^24 || ^25 || ^26 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | enphaseEnvoy |
| License | MIT |
Community signals
| Downloads a week | 1,165 |
|---|---|
| Downloads a month | 10,966 |
| GitHub stars | 67 |
| Open issues | 0 |
| Closed issues | 207 |
| Last code push | 2026-09-29 |
| Latest version | 10.8.1 (2026-09-29) |
| First published | 2020-06-05 |
| Releases | 6546 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- AcBatteryService
- AcBatterySummaryService
- Battery
- C6CombinerControlerService
- C6RgmService
- CarbonMonoxideSensor
- CollarService
- ContactSensor
- EnchargeService
- EnpowerService
- EnsembleService
- EnsembleSummaryService
- EnvoyService
- EvePowerMeter
- Fan
- GerneratorService
- HumiditySensor
- Lightbulb
- LiveDataService
- LockMechanism
- MeterService
- MicroinverterService
- MotionSensor
- NetworkInterfaceService
- OccupancySensor
- Outlet
- PowerAndEnergyService
- QrelayService
- Switch
- WirelessConnectionKitService
