evcc Linux Images for Raspberry Pi and other SBCs

✨ This is the recommended way for beginners to install evcc.

Repository for ready-to-use evcc linux images for popular single-board computers like Raspberry Pi and NanoPi.

Image contents

• ☀️🚗 evcc for smart energy management (stable version)
• 🔒 Secure by default with HTTPS (Caddy)
• 📶 WiFi setup hotspot (via comitup), optional
• 🛠️ System management UI (Cockpit)
  • Terminal
  • Package updates
  • Network configuration
  • User management
  • File navigator
  • System logs
• 🛡️ Automatic security updates (Debian patches, checked daily)
• 🐧 Based on Armbian

Getting Started

1. Download your image file from releases.
2. Flash your image to an SD card using balenaEtcher or USBImager.
3. Insert your SD card and connect your device with power and ethernet.
4. Navigate to https://evcc.local/ in your browser. Accept the self-signed certificate.
5. You should see the evcc web interface.
6. Alternatively: Use the evcc iOS/Android app to connect to your evcc instance.

For more detailed instructions, see the full documentation.

Supported Boards

• Raspberry Pi 4, 5, 3B+, Zero 2W

  • Image: evcc_[version]_rpi.img.zip
  • WiFi setup: supported
  • Storage: SD Card

• NanoPi R3S

  • Image: evcc_[version]_nanopi-r3s.img.zip
  • WiFi setup: via USB adapter (see below)
  • Storage: SD or eMMC (see instructions)

Available Services

Service	Port	Protocol	URL
evcc UI	443	HTTPS	https://evcc.local/
OCPP	8887	WSS	wss://evcc.local:8887/<stationid>
Cockpit UI	9090	HTTPS	https://evcc.local:9090/

Note: The above services use self-signed certificates. You'll need to accept the certificate warning in your browser, or disable certificate verification in your EV charger's OCPP configuration. If you have compatibility problems, use the unencrypted alternatives below:

Service	Port	Protocol	URL
evcc UI	7070	HTTP	http://evcc.local:7070/
OCPP	8886	WS	ws://evcc.local:8886/<stationid>

Administration

Cockpit UI

Login to the Cockpit web console on https://evcc.local:9090/

• username admin
• password admin

You'll be prompted to change your password. Remember the new password. There is no reset.

You can see system health, update packages and run terminal commands.

Alternatively: connect via SSH ssh [email protected]

Updating evcc

Login to Cockpit (https://evcc.local:9090/) and click on Software updates in the left navigation. Update evcc (and other packages) as needed.

Nightly Builds

The image uses the stable evcc version by default. To switch to nightly builds, login to Cockpit (https://evcc.local:9090/), click on Terminal in the left navigation, and run these commands:

# Add the nightly repository
curl -1sLf 'https://dl.evcc.io/public/evcc/unstable/setup.deb.sh' | sudo -E bash

# Update and upgrade to nightly
sudo apt update
sudo apt upgrade -y

To switch back to stable:

# Remove nightly repository
sudo rm /etc/apt/sources.list.d/evcc-unstable.list

# Reinstall stable version
sudo apt update
sudo apt install --reinstall evcc

For more details, see the Linux installation documentation.

Hardware Recommendations

Storage

16GB storage should be enough when only using evcc. We recommend running your system from eMMC instead of SD card. NanoPi boards come with built-in eMMC storage. If you decide to run your system directly from SD card, be sure to read Armbian's recommendations first.

CPU and RAM

All above boards have plenty of CPU and RAM for evcc. 1GB RAM should be enough. Pick 2GB if you want to be on the safe side.

Network Recommendations

For reliability we strongly suggest using a wired ethernet connection.

Wireless Setup

If a wired setup is not possible this image also includes a wireless onboarding process. The device will create a WiFi setup hotspot if no internet connection is detected after 30 seconds of boot.

1. Power your device
2. Connect to evcc-setup network from your phone or laptop
3. Select your WiFi network and enter the password
4. Connect back to your home network
5. Continue with step 4 from Getting Started

Note: WiFi setup is a one-time process. To reconfigure WiFi at a new location, simply reboot the device and evcc-setup will appear again.

For ethernet-only boards like the NanoPi, you can use WiFi USB dongles. The following adapters have been tested successfully:

• EDUP EP-B8508GS
• add your's here ...

Hardware Comparison

CPU performance is not critical for evcc operation as it's not CPU-intensive. These benchmarks are provided for reference and future-proofing considerations.

Benchmark methodology: Results obtained using sysbench with the following commands:

# CPU Single
sysbench --test=cpu --cpu-max-prime=20000 --num-threads=1 --max-time=200 run
# CPU Multi
sysbench --test=cpu --cpu-max-prime=20000 --num-threads=4 --max-time=200 run

Building Images Locally

You'll need Docker Desktop installed and running.

# Clone and enter the repository
git clone https://github.com/evcc-io/images.git
cd images

# Build for Raspberry Pi
./build-local.sh --board rpi

The image will be at dist/evcc_local_rpi.img.zip.

Contributing

• Report issues
• Submit pull requests

License

• MIT

Thanks 💚

Huge thanks to the Armbian project for making building these images easy! They also accept donations. Wink wink.