Raspberry Pi & Co.
Mit dem evcc-Linux-Image installierst du evcc am einfachsten auf einem Raspberry Pi oder ähnlichen Kleincomputern. Das Image ist fertig vorkonfiguriert, und du richtest alles über die Weboberfläche ein.
Schnellstart
Abschnitt betitelt „Schnellstart“-
Datei herunterladen
Abschnitt betitelt „Datei herunterladen“Lade das aktuelle evcc-Image für dein Gerät herunter:
Gerät Download Raspberry Pi (3, 4, 5, Zero 2 W) evcc_raspberry-pi.img.zip (SHA) NanoPi Zero2 evcc_nanopi-zero2.img.zip (SHA) NanoPi R3S evcc_nanopi-r3s.img.zip (SHA) NanoPi R76S evcc_nanopi-r76s.img.zip (SHA) NanoPi NEO3 Plus evcc_nanopi-neo3-plus.img.zip (SHA) NanoPi R28S evcc_nanopi-r28s.img.zip (SHA) Weitere Infos zu den einzelnen Geräten (WLAN, Speicher, Leistung) findest du in der Liste der unterstützten Geräte.
-
SD-Karte beschreiben
Abschnitt betitelt „SD-Karte beschreiben“Schreibe jetzt das heruntergeladene Image auf die SD-Karte. Wir verwenden dafür Armbian Imager. Alternativ kannst du auch Rufus (Windows) verwenden.
- Stecke die SD-Karte in den Computer
- Öffne Armbian Imager
- Use Custom Image → wähle die heruntergeladene Datei aus
- Wähle deine SD-Karte aus
- Starte das Flashen und warte, bis es fertig ist
-
Raspberry Pi starten
Abschnitt betitelt „Raspberry Pi starten“- Stecke die SD-Karte in den Raspberry Pi
- Schließe ein Netzwerkkabel an (empfohlen) oder richte das WLAN ein
- Schließe das Netzteil an
- Warte, bis er gestartet ist
-
evcc Web UI
Abschnitt betitelt „evcc Web UI“
- Öffne den Browser
- Gib https://evcc.local/ ein
- Akzeptiere die Zertifikatswarnung (normal, die Verbindung ist verschlüsselt)
- Alternativ via IP-Adresse, z. B.
https://192.168.1.123/(IP im Router ermitteln)
- Vergib ein Administrator-Passwort (beim ersten Start)
- Richte deine Geräte ein (Wallbox, PV-Anlage, Hausbatterie, Fahrzeuge)
- Hinweis: Mindestens ein Ladepunkt muss angelegt werden, damit evcc läuft.
Weitere Details zur Einrichtung findest du in der Konfigurationsanleitung.

Fertig! 🎉
Systemkonfiguration und Updates funktionieren über Cockpit. Melde dich dort einmal an, um das Standard-Linux-Passwort zu ändern.
WLAN einrichten
Abschnitt betitelt „WLAN einrichten“Falls kein Netzwerkkabel vorhanden ist, erstellt der Raspberry Pi einen WLAN-Hotspot für die Ersteinrichtung.
- Suche am Smartphone nach dem WLAN „evcc-setup“
- Verbinde dich (kein Passwort nötig)
- Wähle dein Heim-WLAN aus der Liste aus
- Gib das WLAN-Passwort deines Heimnetzwerks ein
- Der Raspberry Pi beendet den Hotspot und verbindet sich mit deinem Heim-WLAN
- Weiter mit evcc Web UI
Die WLAN-Konfiguration kann auch später über Cockpit vorgenommen werden.
Systemverwaltung via Cockpit
Abschnitt betitelt „Systemverwaltung via Cockpit“Cockpit ist eine grafische Systemverwaltung für Linux. Hier kannst du dein System konfigurieren, Updates installieren und Netzwerkeinstellungen ändern.
- URL: https://evcc.local:9090/
- Benutzer:
admin - Passwort:
admin(initial)
Beim ersten Login wirst du aufgefordert, das Standardpasswort zu ändern. Wähle ein sicheres Passwort für die Systemverwaltung. Falls du es vergisst, musst du die SD-Karte neu flashen. Es gibt keine „Passwort vergessen“-Funktion.

Wichtige Funktionen:
- System: Übersicht über CPU, Speicher und Festplatte
- Logs: Systemlogs einsehen
- Networking: Netzwerk und WLAN konfigurieren
- Navigator: Datei-Editor für Konfigurationsdateien
- Terminal: Zugriff auf die Kommandozeile
- Software Updates: System aktualisieren
Hardware-Empfehlungen
Abschnitt betitelt „Hardware-Empfehlungen“evcc läuft auf verschiedenen Kleincomputern und braucht nur wenig Ressourcen. Bereits 1 GB RAM reichen völlig aus.
Unterstützte Geräte:
- Raspberry Pi 4 und 5: reichlich Leistung
- Raspberry Pi 3 und Zero 2 W: ausreichend, wenn evcc die einzige Anwendung ist
- NanoPi Zero2, R3S und R76S: kompakt, günstig, mit Metallgehäuse und integriertem eMMC-Speicher erhältlich
Speicher: Eine SD-Karte oder ein eMMC mit mindestens 16 GB. Für längere Lebensdauer empfehlen wir eMMC statt SD-Karte (z. B. beim NanoPi). SD-Karten können durch häufige Schreibvorgänge verschleißen. Siehe auch Armbian-Empfehlungen.
Netzteil: Verwende das Original-Netzteil des jeweiligen Herstellers.
Netzwerk: Eine Kabelverbindung wird dringend empfohlen. WLAN ist möglich, aber oft weniger stabil.
Über das evcc-Linux-Image
Abschnitt betitelt „Über das evcc-Linux-Image“Das evcc-Linux-Image basiert auf Armbian und bietet einige praktische Funktionen:
Verfügbare Dienste
Abschnitt betitelt „Verfügbare Dienste“| Dienst | URL | Hinweis |
|---|---|---|
| evcc-Weboberfläche | https://evcc.local/ |
selbstsigniertes Zertifikat (Standard) |
http://evcc.local:7070/ |
unverschlüsselt | |
| OCPP-Server | ws://evcc.local:8887/<station-id> |
unverschlüsselt (Standard) |
wss://evcc.local:8888/<station-id> |
selbstsigniertes Zertifikat | |
| Cockpit | https://evcc.local:9090/ (initiales Passwort: admin) |
selbstsigniertes Zertifikat |
| SSH | ssh admin@evcc.local (initiales Passwort: admin) |
Das Image bietet für alle Dienste auch eine verschlüsselte Variante an. Wir empfehlen verschlüsselte Verbindungen auch im lokalen Netzwerk. Einige Wallboxen unterstützen bei OCPP keine selbstsignierten Zertifikate. Nutze in dem Fall unverschlüsseltes WS als Fallback.
Updates
Abschnitt betitelt „Updates“- Betriebssystem: Sicherheitsupdates werden automatisch installiert
- evcc: Updates können manuell über Cockpit durchgeführt werden
Zugriff per SSH
Abschnitt betitelt „Zugriff per SSH“Du kannst dich via SSH mit dem Benutzer admin verbinden (gleiche Zugangsdaten wie Cockpit).
Weitere technische Details findest du im GitHub-Repository.
Nächste Schritte
Abschnitt betitelt „Nächste Schritte“Im Bereich Funktionen kannst du alle Möglichkeiten von evcc kennenlernen. Lade dir auch die iOS-/Android-App herunter.