---
title: "FoxESS Control"
description: "FoxESS Control is a Marketplace integration for Home Assistant. It has 121 installs sharing analytics, needs the vendor's cloud and was last updated September 4, 2026."
canonical: "https://vulpo.app/integrations/marketplace/nicois-foxess-control"
url: "https://vulpo.app/integrations/marketplace/nicois-foxess-control.md"
last-updated: "2026-10-23"
version: "1.4"
---

# FoxESS Control

> FoxESS Control is a Marketplace integration for Home Assistant. It has 121 installs sharing analytics, needs the vendor's cloud and was last updated September 4, 2026.

From the [repository description](https://github.com/nicois/foxess-control):

> Allow Home Assistant to modify FoxESS inverter charge/discharge modes

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=nicois&repository=foxess-control&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=nicois&repository=foxess-control&category=integration)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **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.

### FoxESS Control

- **API Key**
- **Device Serial Number**

### FoxESS Control — entity mode

- **Work mode entity (select)**
- **Charge power limit entity (number)**
- **Discharge power limit entity (number)**
- **Min SoC entity (number)**
- **Battery SoC entity (sensor)**
- **House load power entity (sensor)**
- **Solar generation power entity (sensor)**
- **Cumulative feed-in energy entity (sensor)**
- **Battery charge power entity (sensor)**
- **Battery discharge power entity (sensor)**
- **Grid consumption power entity (sensor)**
- **Grid feed-in power entity (sensor)**
- **Max grid export limit entity (number, optional — enables hardware-actuator tapering)**
- **Inverter rated power (W)**

### FoxESS Control — battery

- **Minimum SoC on Grid (%)**
- **Battery Capacity (kWh)**
- **Minimum Power Change for Smart Charge (W)**

### Real-Time Data (Optional)

- **Web Username**
- **Web Password (or MD5 hash)**

### After setup

- **Minimum SoC on Grid (%)**
- **Battery Capacity (kWh)**
- **Minimum Power Change for Smart Charge (W)**
- **Minimum API fdSoc (%) — ⚠️ Values below 11 may not work with all firmware versions**
- **API Polling Interval (seconds)**
- **BMS Temperature Polling Interval (seconds)**
- **Smart Headroom (%)**
- **Grid Export Limit (W) — net export cap set on inverter (0 = no limit)**
- **WebSocket real-time data mode**
- **Additional solar power variable**: Optional. For AC-coupled systems where a second inverter's generation is reported in a separate FoxESS variable (e.g. meterPower2). Its value is added to the solar reading. Leave blank otherwise.
- **Work mode entity (select)**
- **Charge power limit entity (number)**
- **Discharge power limit entity (number)**
- **Min SoC entity (number)**
- **Battery SoC entity (sensor)**
- **House load power entity (sensor)**
- **Solar generation power entity (sensor)**
- **Cumulative feed-in energy entity (sensor)**
- **Battery charge power entity (sensor)**
- **Battery discharge power entity (sensor)**
- **Grid consumption power entity (sensor)**
- **Grid feed-in power entity (sensor)**
- **Max grid export limit entity (number, optional — enables hardware-actuator tapering)**
- **Inverter rated power (W)**

Texts from the code of [nicois/foxess-control](https://github.com/nicois/foxess-control).

## Entities

- **Binary sensors**: Smart Charge Active, Smart Discharge Active
- **Sensors**: Battery SoC, Charge Rate, Discharge Rate, House Load, Solar Power, Battery Temperature, BMS Battery Temperature, Grid Consumption, Grid Feed-in, Generation, Battery Voltage, Battery Current, and 31 more

## Actions

- **Clear overrides**: Return the inverter to self-use mode, clearing all or selected overrides.
  Fields: Mode
- **Feed-in**: Prioritise feeding excess solar to the grid for a set duration, optionally at a specific time and power limit.
  Fields: Duration, Power limit, Start time, Remove conflicting overrides instead of aborting
- **Force charge**: Charge the battery for a set duration, optionally at a specific time and power limit. The inverter automatically reverts to self-use when the window ends.
  Fields: Duration, Power limit, Start time, Remove conflicting overrides instead of aborting
- **Force discharge**: Discharge the battery for a set duration, optionally at a specific time and power limit. The inverter automatically reverts to self-use when the window ends.
  Fields: Duration, Power limit, Start time, Remove conflicting overrides instead of aborting
- **Smart charge**: Charge the battery within a time window, pacing the charge rate to reach a target SoC by the end of the interval. Charging may start late if the target can be reached in less time.
  Fields: Start time, End time, Target SoC, Maximum power, Remove conflicting overrides instead of aborting
- **Smart discharge**: Discharge the battery within a time window. Stays in self-use as long as possible, then switches to forced discharge at full power when needed to meet the target by the window end. Reverts to self-use when the minimum SoC or feed-in energy limit is reached.
  Fields: Start time, End time, Power limit, Minimum SoC to stop discharge, Feed-in energy limit, Remove conflicting overrides instead of aborting

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  Unmanaged work mode detected, Smart charge can't reach target SoC

## From the README

> A Home Assistant custom integration for monitoring and controlling FoxESS inverter battery modes.
>
> FoxESS Control polls real-time inverter data (battery SoC, charge/discharge power, solar generation, house load, temperature) and provides actions for force charge, force discharge, smart charge/discharge with SoC targets, and feed-in management. It supports two backends: the FoxESS Cloud API and local entity mode via foxess\_modbus. It includes comprehensive polled sensors and can fully replace the foxess-ha integration — see Migrating from foxess-ha.

From the README of [nicois/foxess-control](https://github.com/nicois/foxess-control#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries
- Brand: [FoxESS](https://vulpo.app/integrations/foxess.md)
- Number: 121 installs sharing analytics; 21 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: v1.0.21, last updated September 4, 2026
- Domain: `foxess_control`
- Source: <https://github.com/nicois/foxess-control>
- Issues: <https://github.com/nicois/foxess-control/issues>
- Screenshot: https://vulpo.app/integrations-img/11f22ce1c26631d9.webp (from nicois/foxess-control's README)
- Screenshot: https://vulpo.app/integrations-img/3542521daa0627b3.webp (from nicois/foxess-control's README)
- Screenshot: https://vulpo.app/integrations-img/9892674efb3f6edc.webp (from nicois/foxess-control's README)

In Vulpo: Chart card, Apple Watch

## Other ways in for FoxESS

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [HA & FoxESSCloud integration](https://vulpo.app/integrations/marketplace/macxq-foxess-ha.md) | Marketplace integration | 1.5k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [FoxESS - Modbus](https://vulpo.app/integrations/marketplace/nathanmarlor-foxess-modbus.md) | Marketplace integration | 1.3k installs sharing analytics | Works locally | Updated in the last 6 months |
| [FoxESSCloud API](https://vulpo.app/integrations/marketplace/softxperience-home-assistant-foxess-api.md) | Marketplace integration | 292 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [FoxESS OpenAPI](https://github.com/fruffin/home-assistant-foxess-openapi) | Marketplace integration | 46 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |
| [FoxESS T Series](https://github.com/LucasTor/FoxESS-T-series) | Marketplace integration | 10 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-23. Source: https://vulpo.app/integrations/marketplace/nicois-foxess-control

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/nicois-foxess-control
- 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