# Home Assistant

> Installiere evcc als Home-Assistant-App ganz ohne Kommandozeile und erfahre, wo die Konfiguration liegt, wie Updates laufen und welche Tipps es für Fortgeschrittene gibt.

> **Wichtig**
>
> Die evcc Home Assistant App ist eine Community Integration und wird “noch” nicht offiziell von den evcc Maintainern unterstützt. Der Grund dafür ist, dass im Fehlerfall wichtige Daten nicht einfach bereitgestellt werden können (fehlende `evcc cli`).

> **Datenmigration**
>
> Bitte beachte, dass wir seit dem 16.02.2025 mit der Version 0.200.1 die Pfade im App geändert haben, um mit der [Vorgabe](https://developers.home-assistant.io/blog/2023/11/06/public-addon-config/) von Home Assistant konsistent zu sein.
>
> Ab sofort werden also folgende Pfade in der App verbunden:
>
> * `/homeassistant/` -> zeigt in Home Assistant auf `/homeassistant/` bzw. `/config/`.
> * `/config/`-> zeigt in Home Assistant auf `/addon_configs/49686a9f_evcc/`.
>
> Falls du von einer alten Version updatest, wird Deine Konfigurationsdatei automatisch in das neue Verzeichnis kopiert. Die Datenbank kopieren wir nur, wenn sie ebenfalls in `/config/` lag. Falls du sie in `/data/` hattest, bleibt sie dort. Den alten Dateien fügen wir `.migrated` an. Diese können dann von dir händisch gelöscht werden.

Diese Anleitung beschreibt die Installation von evcc als Home Assistant App. Im Gegensatz zur [Linux-Installation](/de/installation/linux) oder [Docker-Installation](/de/installation/docker) benötigst du hier kein Kommandozeilenwissen.

## Voraussetzungen

Du benötigst eine Home Assistant Installation mit aktiviertem App Store. Abhängig von deiner Installationsart kann es sein, dass diese Funktion nicht verfügbar ist. Siehe [Home Assistant Dokumentation](https://www.home-assistant.io/installation/#advanced-installation-methods) für weitere Informationen.

## Installation

* Release

  Die aktuelle stabile Version.

  1. Repository automatisch hinzufügen: Klicke auf den nachfolgenden Button und dann auf **Open link**, dann auf **Hinzufügen**. [![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fevcc-io%2Fhassio-addon)

  2. Repository manuell hinzufügen:

     1. Klicke auf **Einstellungen** → **Apps** → **App installieren**

     2. Klicke auf die **drei Punkte** → **Repositories**

     3. Füge die Repository-URL ein und klicke auf **Hinzufügen**

        ```plaintext
        https://github.com/evcc-io/hassio-addon
        ```

  3. Webseite neu laden

  4. Finde die App **evcc** und klicke sie an

  5. Klicke auf die Schaltfläche **Installieren**

* Nightly

  Die aktuelle Entwicklerversion. Täglich aktualisiert. Kann instabil sein. Kann zwar parallel zur Release Version installiert werden, aber es kann immer nur eine Version gleichzeitig laufen. Falls du das Nightly nutzt, ändern sich auch die in dieser Anleitung genannten Pfade bzw. Docker Container Namen, d.h. statt `evcc` muss `evcc-nightly` verwendet werden.

  1. Repository automatisch hinzufügen: Klicke auf den nachfolgenden Button und dann auf **Open link**, dann auf **Hinzufügen**. [![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fevcc-io%2Fhassio-addon)

  2. Repository manuell hinzufügen:

     1. Klicke auf **Einstellungen** → **Apps** → **App installieren**

     2. Klicke auf die **drei Punkte** → **Repositories**

     3. Füge die Repository-URL ein und klicke auf **Hinzufügen**

        ```plaintext
        https://github.com/evcc-io/hassio-addon
        ```

  3. Webseite neu laden

  4. Finde die App **evcc (nightly)** und klicke sie an

  5. Klicke auf die Schaltfläche **Installieren**

## Konfiguration

evcc kann auf zwei Arten konfiguriert werden:

### Weboberfläche (empfohlen)

Gehe in der **evcc** App in den Tab **Information** und aktiviere **In Seitenleiste anzeigen** (evcc UI <http://your-ha-instance-ip-address:7070>)

Gehe zum Tab **Konfiguration** und wähle dein Arbeitsverzeichnis aus (Beispiel):

![Home Assistant App Konfigurations-UI](/_astro/ha_configuration_ui.jinlrQpe.webp)

```sh
- sqlite_file: /data/evcc.db
```

Lasse den Abschnitt Netzwerk unverändert.

Starte die App. Öffne dann die evcc Oberfläche über die Seitenleiste:

* Du wirst aufgefordert ein Administrator-Passwort zu vergeben
* Anschließend kannst du deine Geräte direkt über die Weboberfläche einrichten
* Die Einstellungen werden automatisch in der Datenbank gespeichert

### Konfigurationsdatei (traditionell)

Alternativ kannst du eine `evcc.yaml` Konfigurationsdatei verwenden.

Gehe zum Tab **Konfiguration** und füge die Konfigurationsdatei zu deinem Arbeitsverzeichnis hinzu:

```sh
- config_file: /config/evcc.yaml
- sqlite_file: /data/evcc.db
```

Lege eine Konfigurationsdatei `evcc.yaml` in deinem App-Stammkonfigurationsordner (`/addon_configs/49686a9f_evcc`) an. Falls dieser Ordner noch nicht existiert, erstelle ihn manuell.

Um die Konfigurationsdatei anzulegen bzw. zu editieren, hast du verschiedene Möglichkeiten:

* [Visual Studio Code](https://github.com/hassio-addons/addon-vscode): Wähle das Hamburger-Menü oben links aus und wähle “File”, “Open Folder…”, select `/addon_configs/49686a9f_evcc`
* [File Editor](https://github.com/home-assistant/addons/tree/master/configurator): Stelle sicher, dass du die Option “Enforce Basepath” in der App Konfiguration deaktiviert hast, starte das App neu und navigiere nach `/addon_configs/49686a9f_evcc`
* [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh): Navigiere nach `/addon_configs/49686a9f_evcc` und verwende z. B. nano

Details zur Erstellung der Konfigurationsdatei findest du unter [Einrichtung](/de/installation/configuration).

Wenn du erstmal mit einer Demo starten möchtest, starte evcc mit dem Parameter `--demo`. Weitere Informationen findest du unter [CLI Referenz](/de/reference/cli/evcc).

## Aktualisierungen

Die Aktualisierung auf die neueste Version von evcc ist in den Home Assistant Update-Prozess integriert.

## Erweiterte Tips

Um die folgenden Funktionen auszuführen, benötigst du SSH Zugriff auf Home Assistant. Diesen kannst du z. B. mit der oben erwähnten SSH App bekommen.

* Installiere [Advanced SSH & Web Terminal](https://github.com/hassio-addons/addon-ssh)
* deaktiviere den “secure mode” in der App-Konfiguration
* Starte die App neu
* Öffne die Benutzeroberfläche der App

### Wie komme ich an die evcc Datenbank?

Zeige die Dateien in `/data` an:

```sh
docker exec addon_49686a9f_evcc ls -la /data
```

Kopiere die `evcc.db` nach `/addon_configs/49686a9f_evcc`:

```sh
docker cp addon_49686a9f_evcc:/data/evcc.db /addon_configs/49686a9f_evcc/
```

### Wie kann ich das evcc CLI nutzen?

Öffne eine Shell zum evcc Docker Container:

```sh
docker exec -it addon_49686a9f_evcc /bin/sh
```

Starte evcc CLI Befehle (hier als Beispiel `checkconfig`):

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

Schließe die Shell im evcc Docker Container wenn du fertig bist:

```sh
exit
```

### Wie kann ich meinen externen Adapter/Hat in der Home Assistant evcc App (Home Assistant OS, Raspberry Pi) verwenden?

Wenn sich dein Home Assistant-Gerät in der Nähe deines Zählers (PV, Batterie, Netz, …) kannst du die Daten auch direkt über Modbus (bspw. USB) abrufen.

Dafür musst du externe Geräte für Home Assistant aktivieren, was auch die evcc-App einschließt. Kommentiere dafür die Zeile `uart = 1` in der `config.txt` auf der Home Assistant OS Boot-Partition ein.

**/config.txt**

```ini
uart = 1
```

Nach einem Neustart sollte dein Gerät für die evcc-App verfügbar sein (wahrscheinlich als `/dev/ttyS0` oder `/dev/ttyUSB`)

## Nächster Schritt: Integration

Wenn dein System läuft, kannst du dich um die Integration zwischen evcc und Home Assistant kümmern. Unter [Integrationen → Home Assistant](/de/smarthome/home-assistant) findest du mehr Informationen. Du kannst evcc Daten in Home Assistant visualisieren oder Automatisierungen auf Basis von evcc erstellen.