evcc Images for Raspberry Pi and other SBCs

⚠️ Still experimental, feedback welcome!
These images are currently in experimental phase. Please report any issues or share your feedback to help us improve.

Repository for ready-to-use Debian-based evcc images for popular single-board computers like Raspberry Pi, Radxa 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

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	Image Name	Instructions
Raspberry Pi 5	✅	rpi4b	see above
Raspberry Pi 4	✅	rpi4b	see above
Raspberry Pi 3b	⚠️	rpi4b	see above
NanoPi R3S	✅	nanopi-r3s	see above, then copy to eMMC
Radxa E52C	✅	radxa-e52c	see above, then copy to eMMC alternative: flash directly 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. Radxa and 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 Radxa and NanoPi, you can use WiFi USB dongles. The following adapters have been tested successfully:

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

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.