Einrichtung
Nach der Installation von evcc kannst du deine Geräte und Einstellungen konfigurieren. Der empfohlene Weg ist die Konfiguration über die Weboberfläche. Für fortgeschrittene Nutzer steht auch die dateibasierte Konfiguration zur Verfügung.
Über die Weboberfläche
Abschnitt betitelt „Über die Weboberfläche“Erste Schritte
Abschnitt betitelt „Erste Schritte“- evcc starten: Nach der Installation starte evcc gemäß der Anleitung für dein System
- Browser öffnen: Gehe zu
http://<deine-ip>:7070(z. B.http://evcc.local:7070oderhttp://192.168.1.50:7070) - Administrator-Passwort festlegen: Beim ersten Start wirst du aufgefordert, ein Passwort zu vergeben
- Einrichtung: Folge den Anweisungen auf der Willkommensseite
Geräte hinzufügen
Abschnitt betitelt „Geräte hinzufügen“Im Konfigurationsbereich kannst du folgende Komponenten einrichten:
- Ladepunkte & Heizungen (empfohlen): Wallboxen und Wärmepumpen
- Netzanschluss (empfohlen): Netzzähler, Stromtarife und Einspeisebegrenzer, wichtig für ein korrektes Energiemanagement
- PV & Hausbatterie (optional): PV-Anlagen und Hausbatterien
- Fahrzeuge (optional): Fahrzeugintegrationen für Batteriekapazität und Ladestand, ermöglichen intelligenteres Laden
Mindestens ein Zähler oder Ladepunkt muss konfiguriert sein, damit das System läuft.
Die meisten Geräte werden über ihre IP-Adresse oder ihren Hostnamen angesprochen. Das Feld IP Adresse oder Hostname schlägt die in deinem Netzwerk gefundenen Geräte mit Adresse, Hostname und Hersteller vor. Geräte, die zum gewählten Gerätetyp passen, stehen unter Passend, alle anderen unter Weitere. Einträge, die von einem anderen Gerät bereits verwendet werden, sind markiert. Passt genau ein Gerät, wird es automatisch eingetragen. Du kannst eine Adresse jederzeit selbst eintippen. Die Suche läuft nur lokal und nur, während du ein Gerät einrichtest. Sie findet nur Geräte im selben Netzwerksegment wie deine evcc-Instanz. Geräte in anderen VLANs oder Subnetzen werden nicht gefunden. In einem Docker-Container ist dafür das Host-Netzwerk (alternativ macvlan) nötig, da der Container im Bridge-Modus das lokale Netzwerk nicht sieht.
Integrationen
Abschnitt betitelt „Integrationen“Zusätzlich kannst du verschiedene Dienste und Protokolle einbinden:
- MQTT: Datenaustausch mit anderen Systemen im Netzwerk
- Benachrichtigungen: Push-Nachrichten und E-Mail-Benachrichtigungen
- InfluxDB: Datenexport für Langzeitauswertungen
- EEBUS: Kommunikation mit anderen EEBUS-Geräten
- OCPP Server: Verbindung mit OCPP-fähigen Wallboxen
- Stromkreise: Stromkreisüberwachung und -steuerung
- Modbus-Proxy: Mehrfachzugriff auf Modbus-Geräte
- Sunny Home Manager: Integration via SEMP-Protokoll
- Externe Begrenzung: Leistungsbegrenzung durch Netzbetreiber (§ 14a EnWG, § 9 EEG) oder übergeordnete Energiemanagementsysteme
Sichern & Wiederherstellen
Abschnitt betitelt „Sichern & Wiederherstellen“Die Weboberfläche bietet integrierte Funktionen für Datensicherung:
- Sichern: Datenbank zur Datensicherung herunterladen
- Wiederherstellen: Daten aus einer Sicherungsdatei wiederherstellen
- Zurücksetzen: Konfiguration oder Ladehistorie löschen
Über eine Konfigurationsdatei
Abschnitt betitelt „Über eine Konfigurationsdatei“Manuell erstellen
Abschnitt betitelt „Manuell erstellen“Du kannst die evcc.yaml-Datei auch manuell erstellen.
Hier findest du eine minimale Vorlage, die du als Ausgangspunkt nutzen kannst.
Erstellen
Abschnitt betitelt „Erstellen“Kopiere den Inhalt in eine neue evcc.yaml-Datei.
## minimales Konfigurationsbeispiel
site: title: Zuhause # Anzeigename in der Oberfläche meters: grid: my_grid pv: - my_pv battery: - my_battery
# siehe https://docs.evcc.io/en/docs/reference/configuration/loadpointsloadpoints: - title: Garage # Anzeigename in der Oberfläche charger: my_charger # Wallbox vehicle: my_car # Standard-Fahrzeug
# Zählerdefinitionen# name ist frei wählbar und dient als Referenz bei der Zuordnung der Zähler zu site und loadpoints# Dokumentation siehe https://docs.evcc.io/docs/metersmeters: # durch deinen echten Netzzähler ersetzen - name: my_grid type: template template: demo-meter usage: grid power: -1000 # 1 kW Einspeisung # durch deine echte PV-Anlage ersetzen - name: my_pv type: template template: demo-meter usage: pv power: 4000 # 4 kW Erzeugung # durch deine echte Hausbatterie ersetzen - name: my_battery type: template template: demo-battery usage: battery power: -1000 # 1 kW Batterieladung soc: 50 # 50% Ladestand
# durch deine echte Wallbox ersetzen# siehe https://docs.evcc.io/docs/chargerschargers: - name: my_charger type: template template: demo-charger status: C # lädt power: 2000 # 2 kW Ladeleistung enabled: true # optional
# durch dein echtes Fahrzeug ersetzen (optional)# siehe https://docs.evcc.io/docs/vehiclesvehicles: - name: my_car type: template template: offline title: blauer e-Golf capacity: 50 # in kWh
# deinen echten Netzbezugstarif und deine Einspeisevergütung eintragen# siehe https://docs.evcc.io/docs/tariffstariffs: currency: EUR grid: type: fixed price: 0.29 # EUR/kWh feedin: type: fixed price: 0.10 # EUR/kWhMit dieser Datei kannst du evcc starten. Nutze dafür die jeweilige Anleitung für dein System.
Starte evcc neu und öffne http://<evcc-ip>:7070 im Browser.
Überprüfe, ob die Werte plausibel sind.
Solltest du eine Fehlermeldung erhalten, überprüfe deine Angaben.
Oft sind es Einrückungs- oder Tippfehler. Die Datei ist im YAML-Format verfasst. Mit dem Online-Tool YAML Lint kannst du prüfen, ob deine Datei das richtige Format einhält.
Anpassen
Abschnitt betitelt „Anpassen“Die Datei beinhaltet lediglich Demo-Geräte (demo-charger, demo-meter, demo-battery, offline).
Diese haben feste Werte.
Gehe die Datei nun Stück für Stück durch und passe die Werte an dein Setup an:
- Ersetze die Demo-Geräte durch deine eigenen Zähler, Wallboxen und Fahrzeuge.
- Hast du keine Hausbatterie, kannst du den entsprechenden Abschnitt komplett entfernen.
- Hast du mehrere PV-Anlagen, kannst du die entsprechenden Abschnitte duplizieren.
- Hast du mehrere Wallboxen, kopiere den Ladepunkt- und Wallbox-Abschnitt und passe die Namen an.
Beachte, dass sich die einzelnen Einträge gegenseitig referenzieren.
Im site-Eintrag (meters) werden die Zähler (grid, pv, battery) ihren Rollen zugeordnet.
Hierfür wird immer das name-Feld benutzt.
Namen müssen daher eindeutig sein.
Führe diese Änderungen möglichst Schritt für Schritt durch. Starte nach jeder Änderung evcc neu und überprüfe die Ausgaben im Browser. Dann bemerkst du schnell, wenn du einen Fehler gemacht hast.
Weitere Informationen
Abschnitt betitelt „Weitere Informationen“Die evcc.dist.yaml im Hauptprojekt beinhaltet eine vollständige Liste aller möglichen Konfigurationsoptionen. Ausführlichere Erklärungen zu den Optionen findest du unter Referenz → evcc.yaml.
Willst du eine dynamische Demo sehen, kannst du dir auch den Inhalt der Datei demo.yaml ansehen. Diese Datei beinhaltet JavaScript-basierte Demo-Geräte, die eine eingeschränkte Funktionalität simulieren. Sie wird auch für demo.evcc.io genutzt.
Willst du deine eigene Installation im Demomodus ausführen, dann starte evcc mit dem Parameter --demo.
Weitere Informationen findest du in der CLI-Referenz.
Teste, ob die Konfiguration funktioniert:
evcc -c evcc.yamlÖffne einen Browser und gib die URL ein: http://<deine-ip>:7070 (z. B. http://evcc.local:7070).
Die evcc-Oberfläche sollte nun deine eigenen Geräte anzeigen.
Wenn alles funktioniert, kannst du deine evcc.yaml dorthin verschieben, wo deine Installationsart sie erwartet.
Fehlersuche
Abschnitt betitelt „Fehlersuche“Sollten Fehler auftreten, kannst du dir mit folgenden Befehlen weitere Informationen anzeigen lassen.
-
Syntaxprüfung
Terminal-Fenster evcc -c evcc.yaml checkconfig -
Zähler (Netz, PV, Batterie)
Terminal-Fenster evcc -c evcc.yaml -l debug meter -
Fahrzeuge
Terminal-Fenster evcc -c evcc.yaml -l debug vehicle -
Wallboxen
Terminal-Fenster evcc -c evcc.yaml -l debug charger
Überprüfe die Ausgaben der jeweiligen Befehle auf Plausibilität.