Fox App v2 - TonyM1958/FoxESS-Cloud GitHub Wiki

Information based on frequent questions about how the new Fox App works. For a quick tour of the app, go to Me, Links and select the Tutorials tab.

This section refers to old and new inverter models. Whilst these can vary with firmware updates, newer inverters are second generation designs (KH, H1-G2, H3 Pro, H3 Smart, EVO etc) and older inverters are first generation (H1, H3, AIO)

It also refers to: a) the Fox ESS Cloud website - this can be found here. Use the same username and password as the Fox app. If you open the web site in Chrome, after logging in, tap the Chrome menu and then Add to Home Page. This will create an app shortcut so you can go directly to the Fox v2 web site page next time. b) the Energy Stats app. This can be found in your app store. You will need to generate an API key for this - details are given when you first open the app.

This screen allows you to set some basic inverter operating parameters:

System Min. SOC (also known as Battery Reserve or Min SoC On Grid): sets the battery SoC where discharging will stop when the inverter is operating on-grid and is not running Mode Scheduler. If Mode Scheduler is enabled, you will get an error trying to change this value as it is not used.

System Max. SOC: on older inverters, this sets the battery SoC where grid charging will stop. It has no effect when you are running Mode Scheduler (see below). On newer inverters with up to date firmware, this setting may limit charging from solar (including when Mode Scheduler is enabled - see below.

Backup Cut-off SOC (also know as Min SoC): this sets the battery SoC where discharging will stop when the inverter is operating off-grid. When you reach this, EPS power from the inverter will stop. The off-grid Min SoC must be the same or less than the on-grid Min SOC.

Battery Heating: allows you to configure the battery heating, if your battery supports it. If you have heating and this option isn't present, you may need to your inverter and battery firmware updated.

StormSafe Charging: enable or disable charging from the grid when there are weather warnings for your area.

Note: Fox app v2.2.3 removes access to Import and Export Limits for end-users

Import Limit: sets the maximum power (in Watts) that is allowed to be imported from the grid if your inverter supports this. Import limits are explained here

Export Limit: sets the maximum power (in Watts) that is allowed to be exported to the grid. This can be used to throttle exporting by the inverter but must not be set higher than the maximum export allowed by your network operator (DNO). Inverters also have an export current limit that should be set by your installer and that will take priority over the power limit.

There is no longer a direct link to the grid charge times in the latest Fox app. Previously, these settings could be accessed by tapping the battery on the home page. If you want to edit the simple grid charge times, you need to use the website (Quick Settings) or Energy Stats app (Settings, Battery).

Tap the Work Mode on the Home page to access the work mode settings and then tap the double arrows to make changes.

The basic work modes are explained here

If your work mode shows "VPP Controlled", then your inverter is being controlled by a cloud service (such as Amber) and you cannot make local changes to your settings. You need to contact your cloud service provider and ask them to off-board your inverter to regain control over the settings.

If you don't see Mode Scheduler in the Advanced section, you may need to get your inverter firmware updated.

If you set the work mode to use Mode Scheduler and click the blue arrows, you can set and edit different time periods. You see a screen similar to this:

System Min. SOC and System Max. SOC are shown on the Mode Scheduler screen. Don't be fooled, these settings are nothing to do with Mode Scheduler. They only affect inverter operation when Mode Scheduler is NOT enabled. When setting time periods in Mode Scheduler, each time period you create is set with Min SoC 10% and Max SoC 100% and these over-ride your system settings. You cannot change these values within the Fox app and you will need to use the web site (Quick Settings, see below) or Energy Stats app (Settings, Inverter) if you want to make changes.

To add a time period, click Add a Schedule:



You can now set a time and a work mode (one of the basic modes, Force Charge or Force Discharge). The end time must be after the start time and a time period cannot pass through midnight.

Each time period you set can be enabled or disabled.

For force charge, you can also configure:

Charging Cut-Off SOC: sets the battery SoC where charging from the grid should stop. This should work on newer inverters but is not supported on older inverters. For older inverters, you need to use the web site or Energy Stats app to configure Max SoC within a time period to limit charging. In any case, once the grid charge SoC is reached, the battery will continue to charge to 100% from solar.
Charge Power from Grid: sets the AC power to use for charging on newer inverters. On older inverters, the charge power is fixed (up to 5kW or the inverter rating) and you cannot alter the charge rate within a time period.
Charging from Grid Enabled: if this is on, the charge power is used. If this switch is off, the charge power is 0W and the battery will not charge or discharge and your house will run from the grid. On older inverters, where charge power is not supported, the battery will charge even if charging is disabled.

For Force discharge, you can also configure:

Discharge Cut-off SOC: sets the battery SoC where discharging should stop. On newer inverters, battery discharge will stop when the SoC falls to this level and the house load will be met from the grid for the remainder of the time. On older inverters, the system will revert to self use mode and the battery will supply the house load until Min SoC.
Forced Discharge Power: sets the AC power output by the inverter to supply the house load and export. If the house load exceeds this value, any excess will be drawn from the grid. If the house load is lower than this, any excess will be exported (up to the export limit). If this value is 0W, the battery will not discharge and the house load will be drawn from the grid.

Force Discharge on newer inverters configured using the Fox app or web site currently draws power from the grid instead of the battery after Discharge Cut off SoC. If you use Energy Stats (must be v2.202 or later, Android only) to configure your schedules, your load should be met by the battery after Discharge Cut Off SoC.

If you access the web site and then Quick Settings, you can check your Mode Scheduler settings. The page looks like this:

Each time period, viewed via the web site, has specific Min and Max SOC settings. These are different to the system settings and these are the settings that will apply when Mode Scheduler is active. You cannot see these settings in the app.

To change your Min SoC, you need to edit all of the Mode Scheduler time periods using the web site or Energy Stats app. Changing System Min SoC in the app will make no difference. The value shown in the app is the operating Min SoC being used by Mode Scheduler when it is enabled

The Fox app also creates a default work mode period (Remaining Time Mode in the app, Remaining Time Slots on the web site). This is a hidden time period in the app that spans 00:00 to 23:59 with the work mode you select. You can see this extra period using the web site but cannot delete it.

Don't set a user time period that starts at 00:01 as this may not work because the Remaining Time period pre-empts this by starting at 00:00. If you use 00:00 instead, this seems to work

If you've checked all your charge settings and it still won't charge, check your Import Limit is set correctly.

On newer inveters, there are now 2 Max SoC settings available via the installer settings:.



Max SoC From Grid: the maximum SoC when using the grid charge settings (not when using Mode Scheduler)
Max SoC: the maxiumum SoC for the battery when charging from solar

These settings interact and you cannot set Max SoC lower than Max SoC From Grid. The app now sets Max SoC from System Max SoC. However, you cannot set this lower than Max SoC From Grid or you will get write failure. If you want to change these settings, this needs to be done via the installer settings in the app.

This affects grid charge times but not Mode Scheduler. If you want to charge the battery from the grid to a set level, you need to configure the Charging Cut Off SoC in your Force Charge Mode Scheduler time periods.

The new battery information screen now shows the lowest cell temperature, as opposed to the previous Battery Temperature (which is the BMS electronics temperature, up to 10C higher than the cell temperature). This now gives a much better measure of the actual cell operating temperatures. The effect of temperature on battery performance is explained here.

Within a stack of batteries, the lowest cell temperature is usually the bottom battery and temperatures rise by a few degrees as you go up the stack.

If your battery cells are cold, they may not charge or discharge as fast as expected because the current is limited. 25th March 2026 - updated for app v2.2.5 with changes to System Max SoC settings.
7th March 2026 - updated for app v2.2.3, with changes to Import and Export Limit settings.