HA & FoxESSCloud integration
macxq/foxess-ha · vv0.56
Home Assistant & FoxESS integration. Monitor you photovoltaic installation directly from HA ☀️ ⚡️
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 |
|---|---|---|
sensor | Sensor (temperature, humidity, air quality…) |
What people report
Cloud polling of FoxESS inverters; the cloud is often slow with timeouts. Newer systems like Fox EVO are experimental.
- Works1
- Partly works1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| FoxESS H3 Pro inverter | Works Cloud | PV5/PV6 and dual battery SoC sensors addedSaved copyThis release adds support for FoxESS H3 Pro inverter Added PV5 and PV6 sensors (power, current, voltage) Added bat_soc1 and bat_soc2 for dual battery systems (note original bat_soc will show as 'unknown' on dual battery systems) Excerpt saved from GitHub on 2026-10-23. | PR #242 · 2024-04 | |
| FoxESS EVO system | Partly works Cloud | Experimental support; device detail call fails on EVOSaved copyThe Fox EVO system does not support the device detail (unlike every other Fox inverter - possibly an error?) and the api call fails. The device list is correct and returns much of the information provided by the device detail api call, this modification adds a new config switch `Evo: true` and instead of making the device detail call, it will lookup the information in the device list and use that to fill the missing information. Not all of the device detail information is not provided, however all of the essential items are provided to allow the integration to run correctly (until Fox correct … Excerpt saved from GitHub on 2026-10-23. | PR #326 · 2025-12 |
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
Cloud polling
Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.
Details
| Installs (analytics) | 1,507 (0.21%) |
|---|---|
| GitHub stars | 219 |
| Latest version | v0.56 (2026-10-23) |
| Set up in the UI | Yes |
| Maintainers | @macxq, @r-amado, @fozzieuk |
| License | Apache-2.0 |
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.
Sources
- Documentation: https://github.com/macxq/foxess-ha
- Source code: https://github.com/macxq/foxess-ha
- Issues: https://github.com/macxq/foxess-ha/issues
- HACS: https://hacs.xyz