Raspberry Pi & Co.

Die einfachste Art, evcc auf einem Raspberry Pi oder ähnlichen Kleincomputern zu installieren. Fertig vorkonfiguriert und einfach über die Web UI einzurichten!

Schnellstart

1. 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
   NanoPi Zero2	evcc_nanopi-zero2.img.zip
   NanoPi R3S	evcc_nanopi-r3s.img.zip
   NanoPi R76S	evcc_nanopi-r76s.img.zip

   Diese Links führen immer zur neuesten Version. Prüfsummen und ältere Versionen findest du auf der Releases-Seite.

2. SD-Karte beschreiben

   Falls noch nicht vorhanden: Armbian Imager herunterladen

   • SD-Karte in den Computer stecken
   • Armbian Imager öffnen
   • Eigenes Image verwenden → heruntergeladene Datei wählen
   • Deine SD-Karte auswählen
   • Flashen starten → warten bis fertig

   Alternative

   Statt „Datei herunterladen & SD-Karte beschreiben“ kann man auch mit Hilfe des Raspberry Pi Imager die SD-Karte entsprechend vorbereiten.

   Das evcc Image findet man unter choose OS → other specific-purpose OS → home assistance and home automation → evcc.

3. Raspberry Pi starten

   • SD-Karte in den Raspberry Pi stecken
   • Netzwerkkabel anschließen (empfohlen) - alternativ WLAN einrichten
   • Netzteil anschließen
   • Warten bis gestartet

4. evcc Web UI

   

   • Browser öffnen
   • https://evcc.local/ eingeben
     • Zertifikatmeldung muss akzeptiert werden (normal, Verbindung ist verschlüsselt)
     • Alternativ via IP-Adresse, z.B. https://192.168.1.123/ (IP im Router ermitteln)
   • Administrator-Passwort vergeben (beim ersten Start)
   • Geräte einrichten (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

Falls kein Netzwerkkabel vorhanden ist, erstellt der Raspberry Pi einen WLAN-Hotspot für die Ersteinrichtung.

• Am Smartphone nach WLAN “evcc-setup” suchen
• Verbinden (kein Passwort nötig)
• Dein Heim-WLAN aus der Liste auswählen
• WLAN-Passwort deines Heimnetzwerks eingeben
• 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

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 Standard-Passwort 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: Systemprotokolle einsehen
• Networking: Netzwerk und WLAN konfigurieren
• Navigator: Datei-Editor für Konfigurationsdateien
• Terminal: Zugriff auf die Kommandozeile
• Software Updates: System aktualisieren

Achtung

Das Cockpit-Passwort gilt nur für die Systemverwaltung (inkl. SSH).

Für die evcc Web UI vergibst du separat ein eigenes Administrator-Passwort.

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 - haben ausreichend 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 erhältlich

Speicher: Mindestens 16 GB SD-Karte oder eMMC. 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: Original-Netzteil des jeweiligen Herstellers verwenden.

Netzwerk: Kabelverbindung wird stark empfohlen. WLAN ist möglich, aber oft weniger stabil.

Über das evcc Linux Image

Das evcc Linux Image basiert auf Armbian und bietet einige praktische Funktionen:

Verfügbare Services

Service	URL	Hinweis
evcc Web UI	https://evcc.local/	selbst-signiertes 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>	selbst-signiertes Zertifikat
Cockpit	https://evcc.local:9090/ (initiales Passwort: admin)	selbst-signiertes Zertifikat
SSH	ssh admin@evcc.local (initiales Passwort: admin)

Das Image bietet für alle Services auch eine verschlüsselte Variante an. Wir empfehlen verschlüsselte Verbindungen auch im lokalen Netzwerk. Einige Wallboxen unterstützen bei OCPP keine selbst-signierten Zertifikate. Nutze in dem Fall unverschlüsseltes WS als Fallback.

Updates

• Betriebssystem: Sicherheitsupdates werden automatisch installiert
• evcc: Updates können manuell über Cockpit durchgeführt werden

Zugriff per SSH

Du kannst dich via SSH mit dem admin Benutzer verbinden (gleiche Zugangsdaten wie Cockpit).

Weitere technische Details findest du im GitHub Repository.

Nächste Schritte

Im Bereich Funktionen kannst du alle Möglichkeiten von evcc kennenlernen. Lade dir auch die iOS/Android App herunter.