evcc Linux Images for Raspberry Pi and other SBCs

📦 Beta Release
These images are working well but we're still in beta. Please report any issues to help us reach stable.

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

Image contents

• ☀️🚗 evcc for smart energy management
• 🔒 Caddy reverse proxy for HTTPS
• 🛠️ Cockpit web console for administration
• 📶 comitup for WiFi setup without ethernet
• 🐧 Armbian base image and build system
• 🔐 Automatic security updates enabled (Debian security patches)

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.

Administration

• Login into 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]

Supported Boards

Name	Tested	WiFi	Storage	Image Name	Instructions
Raspberry Pi 5	✅	Built-in	SD only	rpi4b	see above
Raspberry Pi 4	✅	Built-in	SD only	rpi4b	see above
Raspberry Pi 3b	✅	Built-in	SD only	rpi4b	see above
NanoPi R3S	✅	via USB	eMMC & SD	nanopi-r3s	see above, then copy to eMMC

✅ tested
⚠️ untested (but should work)

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 rpi4b

The image will be at dist/armbian_evcc-local_rpi4b.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.