Zendure EV Guard

How does it work?

Requirements

Installation

1. Unzip the archive

Extract the contents of the ZIP file to the directory of your choice, for example:

• Windows: C:\ZendureEvGuard\
• Linux: /home/ZendureEvGuard/
• macOS: /Applications/ZendureEvGuard/

2. Execution rights (Linux / macOS only)

On Linux and macOS, you need to make the file executable before running it:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configure appsettings.json

Open the appsettings.json file located next to the executable and fill in your settings (see the section below).

4. Launch the program

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

The program displays the connection information at startup. Use P to manually pause, R to resume, and Ctrl+C twice to stop cleanly.

sudo useradd -r -s /usr/sbin/nologin zendure
sudo chown -R zendure:zendure /home/ZendureEvGuard

sudo nano /etc/systemd/system/zendure-evguard.service

[Unit]
Description=ZendureEvGuard - EV Charging Battery Protection Daemon
After=network.target

[Service]
Type=simple
WorkingDirectory=/home/ZendureEvGuard
ExecStart=/home/ZendureEvGuard/ZendureEvGuard
Restart=on-failure
RestartSec=10
SyslogIdentifier=zendure-evguard
User=zendure
Environment=DOTNET_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable zendure-evguard
sudo systemctl start zendure-evguard

# View status
sudo systemctl status zendure-evguard

# View logs in real time
sudo journalctl -u zendure-evguard -f

# Restart after an update
sudo systemctl restart zendure-evguard

# Stop the service
sudo systemctl stop zendure-evguard

Configuration — appsettings.json

Here are all the parameters you can configure. The Shelly and ZendureDevice sections are mandatory.

⚡ Shelly required

Configuration of your Shelly Pro 3EM. This is the sensor that measures the electrical consumption of your home.

🔌 Smappee Charging Station optional

The energy station Smappee can be used in two ways:

• As an EV detection source (alternative to Shelly) — if Shelly is disabled, Smappee becomes the power measurement source to detect EV charging. Detection is done via the Smappee cloud API (5-minute blocks, less responsive than Shelly in real-time).
• In parallel with Shelly — if Shelly is active as a detection source, Smappee can still be active to continuously display consumption information (solar, home, grid) and your Smappee EV Wall (charging power, status, etc.) in the logs.

🔋 Zendure Battery required

Configuration of your Zendure SolarFlow 2400 AC hub or others. The IP address can be found in the Zendure app.

🚗 EvDetection

Settings for detecting the charge of your electric vehicle. The algorithm uses a hysteresis: it requires several consecutive readings above the threshold to confirm a charge, and several readings below to confirm the stop.

📬 Notification optional

Receive emails when your batteries pause, resume, or in case of an error. Configure your SMTP server.

📴 Pushover optional

Push notifications to your phone via Pushover. Create an application on pushover.net to obtain your API Token.

💬 Telegram optional

Notifications via a Telegram bot. Create a bot with @BotFather and retrieve your Chat ID.

📈 Monitoring optional

🔄 Update optional

🔑 License after the trial

After the 30-day trial period, add your secret key to activate the PRO license. Your key can be found in your account at top right > "My Account". The license renews automatically in the background.

Example of minimal configuration

Here is a ready-to-use example. Simply replace the IP addresses with those of your devices:

{
  "Shelly": {
    "Enabled": true,
    "Host": "192.168.1.50"
  },
  "ZendureDevice": {
    "Host": "192.168.1.127",
    "Port": 80,
    "DefaultOutputLimit": 2400,
    "DefaultMinSoc": 100
  },
  "EvDetection": {
    "PowerThresholdWatts": 5000
  },
  "Subscription": {
    "SecretKey": "d79d24cc-eb02-48d7-94f8-xxxxxxxxxxxx"
  }
}

With this configuration, the program monitors your Shelly, detects any consumption above 5000W (for example), and restores your batteries with a minimum of 10% (100 ÷ 10) and a maximum output of 2400W. The Subscription section is empty by default: the program runs in trial mode for 30 days. To activate the PRO license, add your secret key from your account top right.

Free Trial & Subscription