# Einrichtung

> Zeigt, wie du evcc nach der Installation einrichtest, am besten in der Weboberfläche oder alternativ mit einer evcc.yaml, mit Minimalbeispiel und Tipps zur Fehlersuche.

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

> **Empfohlen**
>
> Die Weboberfläche ist der einfachste und schnellste Weg, evcc einzurichten.

### Erste Schritte

1. **evcc starten**: Nach der [Installation](/de/installation) starte evcc gemäß der Anleitung für dein System
2. **Browser öffnen**: Gehe zu `http://<deine-ip>:7070` (z.B. `http://evcc.local:7070` oder `http://192.168.1.50:7070`)
3. **Administrator-Passwort setzen**: Beim ersten Start wirst du aufgefordert, ein Passwort zu vergeben
4. **Einrichtung**: Folge den Anweisungen auf der Willkommensseite

### Geräte hinzufügen

Im Konfigurationsbereich kannst du folgende Komponenten einrichten:

* **Ladepunkte & Heizungen** (empfohlen): Wallboxen und Wärmepumpen
* **Netzanschluss** (empfohlen): Hauszähler, Stromtarife und Einspeisebegrenzer – wichtig für korrektes Energiemanagement
* **PV & Batterie** (optional): Solaranlagen und Batteriespeicher
* **Fahrzeuge** (optional): Fahrzeugintegrationen für Akkugröße und Ladestand, ermöglicht 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](/de/installation/docker#network) (alternativ macvlan) nötig, im Bridge-Modus sieht der Container das lokale Netzwerk nicht.

### Integrationen

Zusätzlich kannst du verschiedene Dienste und Protokolle einbinden:

* **MQTT**: Datenaustausch mit anderen Systemen im Netzwerk
* **[Benachrichtigungen](/de/notifications)**: 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
* **Externe Begrenzung**: Leistungsbegrenzung durch Netzbetreiber (§ 14a EnWG, § 9 EEG) oder übergeordnete Energiemanagementsysteme

### 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

> **Traditionelle Methode**
>
> Diese Methode nutzt eine `evcc.yaml` Datei und erfordert Kenntnisse im Umgang mit der Kommandozeile und YAML-Dateien. Einige neue Funktionen sind nur über die Weboberfläche konfigurierbar.

### 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.

**evcc.yaml**

```yaml
## 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](https://wikipedia.org/wiki/YAML) verfasst. Mit dem Online-Tool [YAML Lint](https://www.yamllint.com/) 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](/de/meters), [Wallboxen](/de/chargers) und [Fahrzeuge](/de/vehicles).
* 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](https://github.com/evcc-io/evcc/blob/master/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](/de/reference/configuration).

Willst du eine dynamische Demo sehen kannst du dir auch den Inhalt der Datei [demo.yaml](https://github.com/evcc-io/evcc/blob/master/cmd/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](https://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](/de/reference/cli/evcc).

## Testen

Teste, ob die Konfiguration funktioniert:

```sh
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

  ```sh
  evcc -c evcc.yaml checkconfig
  ```

* Zähler (Netz, PV, Batterie)

  ```sh
  evcc -c evcc.yaml -l debug meter
  ```

* Fahrzeuge

  ```sh
  evcc -c evcc.yaml -l debug vehicle
  ```

* Wallboxen

  ```sh
  evcc -c evcc.yaml -l debug charger
  ```

Überprüfe die Ausgaben der jeweiligen Befehle auf Plausibilität.