# Konfiguration

> Überblick über die Konfiguration per evcc.yaml: wo die Datei liegt, wie sie aufgebaut ist und welche Abschnitte deine Anlage, Ladepunkte und Geräte beschreiben.

evcc kann auf zwei Arten konfiguriert werden:

**1. UI-Konfiguration (empfohlen)**

Die Konfiguration erfolgt über die Weboberfläche unter **Konfiguration**. Die Einstellungen werden automatisch in der Datenbank gespeichert. Weitere Informationen findest du unter [Einrichtung](/de/installation/configuration).

**2. Dateibasierte Konfiguration**

Die Konfiguration über die `evcc.yaml` Datei wird weiterhin unterstützt. Dieser Bereich dokumentiert die YAML-basierte Konfiguration.

> **Parallele Nutzung**
>
> Beide Konfigurationsmethoden können parallel genutzt werden. Geräte (Ladepunkte, Zähler, PV-Anlagen, Batterien, Fahrzeuge) werden aus beiden Quellen zusammengeführt. Bei anderen Einstellungen hat die UI-Konfiguration Vorrang. Details findest du in der [FAQ](/de/faq#ui-migration).

## Dateibasierte Konfiguration (evcc.yaml)

Die Konfigurationsdatei ist im YAML Format geschrieben und hat standardmäßig den Namen `evcc.yaml`. Sie liegt entweder im gleichen Verzeichnis wie das Programm oder bei Linux-Systemen unter `/etc/evcc.yaml`.

Abweichende Pfade können beim Start angegeben werden: `evcc -c /pfad/zur/evcc.yaml`

### Struktur

Die Konfigurationsdatei besteht aus mehreren Bereichen. Um zwischen Bereichen zu referenzieren, haben Geräte einen `name` Parameter zur Identifikation.

Eine Beispieldatei mit vielen Parametern findet man hier: <https://github.com/evcc-io/evcc/blob/master/evcc.dist.yaml>

Hier ein Überblick über die Beziehungen der wichtigsten Bestandteile der Konfiguration:

```
graph TD;
    site("site (Zuhause)")
    subgraph loadpoints
      loadpointA("Carport (charger: KEBA)")
      loadpointB("Garage (charger: Wallbe)")
    end
    subgraph meters
      meterGrid("Discovergy")
      meterPV("SMA Tripower")
      meterBattery("LG RESU")
    end
    subgraph vehicles
      vehicleA("VW ID.4")
      vehicleB("Renault Zoe")
      vehicleC("Tesla Model Y")
    end

    loadpointA -- loadpoint.1 --> site
    loadpointB -- loadpoint.2 --> site

    vehicleA --> loadpointA
    vehicleB --> loadpointA
    vehicleB --> loadpointB
    vehicleC --> loadpointB

    meterGrid -- meters.grid --> site
    meterPV -- meters.pvs --> site
    meterBattery -- meters.batterys --> site
```

### Wie funktioniert evcc? (Ein Blick ins Innere)

Wichtig für die Funktionalität ist ein Netzanschlusszähler (`grid` Zähler). Dieser ermittelt die aktuelle Überschussleistung. Die Messung der Erzeugungsleistung hat in diesem Fall keinen funktionalen Einfluss. Ein Betrieb ist aber auch ohne Netzanschlusszähler möglich. Mehr dazu findest du [hier](/de/faq#einrichtung).

Die Überschussleistung wird mit der Mindestladeleistung verglichen. Ist diese erreicht, startet die Ladung.

Die Mindestladeleistung ergibt sich aus den im Loadpoint definierten Werten [`minCurrent`](/de/reference/configuration/loadpoints) und [`phases`](/de/reference/configuration/loadpoints).

Beispiel: `phases: 1` und `minCurrent: 8`

1 (phases) x 8A (minCurrent) x 230V (Netzspannung) = 1840W (Mindestladeleistung)

#### Manipulationsmöglichkeiten

Normalerweise entspricht die Überschussleistung der verfügbaren Ladeleistung. Die verfügbare Ladeleistung kann jedoch individuell durch mehrere Parameter verändert werden. Diese sind:

* Site: `residualpower`
* Site: `prioritySoc`
* Site: `bufferSoc`
* Site: `aux`
* Loadpoint: `enable: threshold`
* Loadpoint: `disable: threshold`

Die Einstellmöglichkeiten bitte der Beschreibung der jeweiligen Parameter entnehmen.

### Site

Eine *Site* beschreibt den Standort mit den vorhandenen und benötigten Geräten der Hausinstallation und ist für das Regeln der verfügbaren Leistung zuständig.

[Weiterlesen…](/de/reference/configuration/site)

### Loadpoints

*Loadpoints* (Ladepunkte) beschreiben die Ladeinfrastruktur und kombinieren vorhandene *Charger* (Wallboxen), *Vehicle* (Fahrzeuge) und alles weitere was ein Ladepunkt benötigt.

[Weiterlesen…](/de/reference/configuration/loadpoints)

### Chargers

*Chargers* (Wallboxen) beinhaltet eine Liste von Wallboxen und deren Eigenschaften, z. B. wie sie angesprochen werden.

[Weiterlesen…](/de/reference/configuration/chargers)

### Meters

*Meters* (Hausinstallation) ist eine Liste von Geräten welche verschiedene Stromflüsse messen. Dazu gehören:

* Eingekaufter, Verkaufter Strom
* PV erzeugte Ströme
* Ladestrom des EV (falls die Wallbox dies nicht direkt unterstützt)
* Ströme der Hausbatterie(n)

[Weiterlesen…](/de/reference/configuration/meters)

### Curtailers

*Curtailers* (Einspeisebegrenzer) sind Geräte, die ausschließlich die Einspeisung der PV-Anlage auf Anforderung des Netzbetreibers begrenzen (§ 9 EEG), z. B. der SMA Sunny Home Manager 2.0 oder der führende Wechselrichter einer Anlage mit mehreren Wechselrichtern.

[Weiterlesen…](/de/reference/configuration/curtailers)

### Vehicles

Um die Ladung auf einen bestimmten Ladestand (Soc) in EVs zu begrenzen, können hier die vorhandenen Fahrzeuge und Online Zugangsdaten angegeben werden.

[Weiterlesen…](/de/reference/configuration/vehicles)

### HEMS

evcc kann die Ladepunkte und deren Ladeströme an ein anderes Home Energy Management System (HEMS) weitergeben, damit dieses die Informationen z.b. zur Steuerung der Hausbatterie nutzen kann.

[Weiterlesen…](/de/reference/configuration/hems)

### Messaging

In diesem Bereich können Ereignisse definiert werden, bei welchen man informiert werden will. Zur Informationsübermittlung werden eine Reihe von unterschiedlichen Systemen unterstützt.

[Weiterlesen…](/de/reference/configuration/messaging)