Deye Force Discharger

Docker Hub Docker Pulls codecov

A Python application to automate battery discharge scheduling for Deye hybrid inverters via the Deye Cloud API.

Web Interface

No longer maintained since Deye Cloud App now supports this since Apr 2026.

This project was built for AC-coupled Deye hybrid inverter setups where solar input comes from a separate inverter.

In this configuration, the Deye inverter typically operates in "Zero Export to CT" mode to:

• Power household loads from the battery
• Charge the battery from the AC-coupled solar system

When running in "Zero Export to CT" mode, the inverter does not allow force battery discharge to the grid. This means you cannot export stored battery energy during peak electricity pricing windows.

The scheduler monitors the current time, battery SoC, and weather forecast, controlling both the work mode and TOU settings:

1. Within discharge window (e.g., 17:30-19:30) and SoC above cutoff and good weather forecast:

   • Switches to SELLING_FIRST mode
   • Sets TOU window SoC to the cutoff value (e.g., 50%)
   • Battery discharges to grid until cutoff is reached

2. Outside window or SoC at/below cutoff or bad weather forecast:

   • Switches to ZERO_EXPORT_TO_CT mode
   • Sets TOU SoC to reserve value (e.g., 20%) for all periods
   • Normal zero-export operation resumes

The system can automatically skip battery discharge when bad weather is forecasted. This helps preserve battery charge for cloudy/rainy days when solar generation will be insufficient.

Why this matters: During bad weather, solar panels will not generate enough power to recharge the battery. By skipping discharge before bad weather, the battery retains enough charge to cover household needs without importing from the grid.

How it works:

• Fetches 4-day weather forecast from Open-Meteo (free, no API key required)
• Gets solar production forecasts from forecast.solar for accurate predictions
• Compares tomorrow's solar forecast against your minimum threshold (configurable)
• If solar production is expected to be below threshold, discharge is skipped
• Displayed in the web UI with forecast cards showing solar estimates

When you configure your solar system details, the application displays estimated daily solar output for each forecast day. This helps you plan your energy usage and understand when discharge might be beneficial.

How it works:

• Enter your panel capacity (kWp), tilt angle, and direction
• The system fetches accurate predictions from forecast.solar API
• Falls back to weather-based estimation if forecast.solar is unavailable
• Estimates account for your specific location, panel configuration, and weather conditions
• Displayed alongside the weather forecast cards

• Python 3.11+
• Deye Cloud developer account (API credentials)
• Deye hybrid inverter with battery storage

# Pull and run the container
docker run -d \
 --name deye-force-discharger \
 -p 7777:7777 \
 -v $(pwd)/config.json:/app/config.json \
 -e TZ=Australia/Sydney \
 --restart unless-stopped \
 loganhan123/deye-force-discharger:latest

# Start the container
docker-compose up -d

The web interface is available at http://<server_ip>:7777

When you first access the web interface with default configuration, a setup wizard will guide you through:

1. Deye Cloud Configuration - Enter your API credentials and device serial number
2. Location Setup (optional) - Search and select your location for weather forecasts (no API key required!)
3. Solar System Details - Configure your panel capacity, tilt angle, and direction for accurate solar forecasts

Each step includes a Test Connection button to verify your settings before proceeding.

You can also manually edit config.json:

{
 "deye": {
 "api_base_url": "https://eu1-developer.deyecloud.com",
 "app_id": "YOUR_APP_ID",
 "app_secret": "YOUR_APP_SECRET",
 "email": "your@email.com",
 "password": "YOUR_PASSWORD",
 "device_sn": "YOUR_DEVICE_SERIAL"
 },
 "schedule": {
 "force_discharge_start": "17:30",
 "force_discharge_end": "19:30",
 "min_soc_reserve": 20,
 "force_discharge_cutoff_soc": 50,
 "max_discharge_power": 10000
 },
 "weather": {
 "enabled": true,
 "latitude": -33.8688,
 "longitude": 151.2093,
 "timezone": "Australia/Sydney",
 "city_name": "Sydney, New South Wales, AU",
 "min_solar_threshold_kwh": 15,
 "panel_capacity_kw": 6.6
 },
 "free_energy": {
 "enabled": false,
 "start_time": "11:00",
 "end_time": "14:00",
 "target_soc": 100
 }
}

Weather and solar forecasts use free APIs (no API keys required!):

• Open-Meteo for weather forecasts
• forecast.solar for solar production predictions

Panel tilt and direction are automatically calculated from your location for optimal positioning.

1. Register at Deye Cloud Developer Portal
2. Create an application to get your app_id and app_secret
3. Find your device serial number in the Deye app or on the inverter

I have also created an Android app for this and some extra features like showing SoC & charge/discharge status in a 1x1 widget.

Worth considering if you do not have a place to host this.

Join this Google group to become a tester: https://groups.google.com/g/deye-battery-widget-beta-testers then

Web: https://play.google.com/apps/testing/com.deye.batterywidget

Andorid: https://play.google.com/store/apps/details?id=com.deye.batterywidget