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 Weboberfläche

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:7070 oder http://192.168.1.50:7070)
Administrator-Passwort setzen: Beim ersten Start wirst du aufgefordert, ein Passwort zu vergeben
Einrichtung: Folge den Anweisungen auf der Willkommensseite

Geräte hinzufügen

Im Konfigurationsbereich kannst du folgende Komponenten einrichten:

Laden & Heizen (erforderlich): Wallboxen und Wärmepumpen – mindestens ein Gerät muss konfiguriert werden
Netzanschluss (empfohlen): Hauszähler und Stromtarife – wichtig für korrektes Energiemanagement
PV & Batterie (optional): Solaranlagen und Batteriespeicher
Fahrzeuge (optional): Fahrzeugintegrationen für Akkugröße und Ladestand, ermöglicht intelligenteres Laden

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
Lastmanagement: Stromkreisüberwachung und -steuerung
Modbus-Proxy: Mehrfachzugriff auf Modbus-Geräte
Sunny Home Manager: Integration via SEMP-Protokoll
HEMS: Externe Steuerung und §14a EnWG-Integration

Sichern & Wiederherstellen

Die Weboberfläche bietet integrierte Funktionen für Datensicherung:

Sichern: Datenbank herunterladen zur Datensicherung
Wiederherstellen: Daten aus einer Sicherungsdatei wiederherstellen
Zurücksetzen: Konfiguration oder Ladehistorie löschen

über Konfigurationsdatei

Manuell erstellen

Du kannst die evcc.yaml Datei auch manuell erstellen. Hier findest du eine minimale Vorlage, die du als Ausgangspunkt nutzen kannst.

Erstellen

Kopiere den Inhalt in eine neue evcc.yaml Datei.

## minimal configuration example

site:
  title: Home # display name for UI
  meters:
    grid: my_grid
    pv:
      - my_pv
    battery:
      - my_battery

# see https://docs.evcc.io/en/docs/reference/configuration/loadpoints
loadpoints:
  - title: Garage # display name for UI
    charger: my_charger # charger
    vehicle: my_car # default vehicle

# meter definitions
# name can be freely chosen and is used as reference when assigning meters to site and loadpoints
# for documentation see https://docs.evcc.io/docs/meters
meters:
  # replace with your real grid meter
  - name: my_grid
    type: template
    template: demo-meter
    usage: grid
    power: -1000 # 1 kW feed-in
  # replace with your real pv system
  - name: my_pv
    type: template
    template: demo-meter
    usage: pv
    power: 4000 # 4 kW production
  # replace with your real battery
  - name: my_battery
    type: template
    template: demo-battery
    usage: battery
    power: -1000 # 1 kW battery charging
    soc: 50 # 50 % state of charge

# replace with your real charger
# see https://docs.evcc.io/docs/chargers
chargers:
  - name: my_charger
    type: template
    template: demo-charger
    status: C # charging
    power: 2000 # 2 kW charging power
    enabled: true # optional

# replace with your real vehicle (optional)
# see https://docs.evcc.io/docs/vehicles
vehicles:
  - name: my_car
    type: template
    template: offline
    title: blue e-Golf
    capacity: 50 # in kWh

# enter your real grid tariff and feed-in price
# see https://docs.evcc.io/docs/tariffs
tariffs:
  currency: EUR
  grid:
    type: fixed
    price: 0.29 # EUR/kWh
  feedin:
    type: fixed
    price: 0.10 # EUR/kWh

Mit dieser Datei kannst du evcc starten. Nutze dafür die jeweilige Anleitung für dein System.

Testen

Starte evcc neu und öffne deinen Browser unter http://<evcc-ip>:7070. Überprüfe, ob die Werte plausibel sind. Solltest du eine Fehlermeldung erhalten, überprüfe deine Angaben.

Oft sind es auch 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

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 Batterie, kannst du den entsprechenden Abschnitt komplett entfernen.
Hast du mehrere PV-Anlagen, kannst du die entsprechenden Abschnitte duplizieren.
Hast du mehrere Wallboxen, kopiere den Loadpoint- und Charger-Abschnitt und passe die Namen an.

Beachte, dass die einzelnen Einträge sich 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

Die evcc.dist.yaml im Hauptprojekt beinhaltet eine vollständige Liste aller möglichen Konfigurations-Optionen. 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 unter CLI Referenz.

Testen

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 mit den eigenen Geräten zu sehen sein.

Wenn alles funktioniert, kannst du deine evcc.yaml an die Stelle verschieben, die für deine Installation notwendig ist.

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.