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 and you will need to set Min SoC via Mode Scheduler.

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 limits 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 removed the ability to change 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 link to set the grid charge times in the Fox ESS app or web site. You should configure a Force Charge time period in Mode Scheduler instead. When you enable Mode Scheduler, any grid charge times you previously set will be removed.

If you still want to use or edit the grid charge times, you need to first disable Mode Scheduler and then use the inverter front panel (Settings, 0000, Battery, Charge Time) or the Energy Stats app (Settings, Battery, Charge Schedule):

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. If you see the message "Please select a time period with no mode assigned", your times overlap another time period and you must change the time before you can save it, or go back and remove the clashing time period. Do not 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

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 (v2.209 or later) to configure your schedules using the Advanced options, try settings Import Limit = 0. You can also set an Export Limit for the Force Discharge time period.

If you access your Dashboard via the Fox ESS v2 web site and then find Work Mode, Details, you can check your Mode Scheduler settings.



The Work Mode page looks like this:



To disable Mode Scheduler, you need to click the drop down and set a basic work mode.

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 select Edit Schedule and edit all of the Mode Scheduler time periods. Changing System Min SoC in the app will make no difference.

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 using the web site but cannot delete it.

You can also edit your Schedules using the Energy Stats app (Settings, Inverter, Manage Schedules):



To edit your schedules in Energy Stats, tap the Schedule to enter edit mode and then select the time period you want to change. Select Advanced if you want to edit the Min Soc, Charge / Discharge power, Cut off Soc or pv / export / import limits. When you have made your chahges, tap Apply and then Save.

If you've set a schedule but the inverter appears to ignore it and just run in self use, it may be stuck running the Remaining Time Slot 00:00-23:59 and you may need to delete this time period. You can't do this using the Fox ESS app or web site but you can using the Energy Stats app, if needed:

• Go to Settings, Inverter, Manage Schedules
• Tap > to edit your schedule
• Tap the period with time 00:00:00 - 23:59:59
• Delete Time Period
• Save

If you edit your schedules using the Fox app after doing this, it will put the Default Time Slot back again.

If you've done this and checked all your charge settings and your battery still won't charge, check your Import Limit is set correctly. You may need to ask your installer to change this setting.

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 the settings, you need to ask your installer or Fox to update the installer settings. Or, from the inverter, try Settings, 0000, Battery, MaxSocFromGrid and reduce the value.

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. 18th April 2026 - updated for Fox ESS cloud v2 web site changes to Quick Seettings and Mode Scheduler.
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.