Zum Inhalt springen
Smart laden

Docker

evcc lässt sich als Docker-Image installieren. Images gibt es für AMD64, armv6 und arm64. Typische Einsatzzwecke sind NAS-Systeme wie Synology, QNAP, Unraid und TrueNAS.

Bevor du den Container erstellst, musst du entscheiden, wie er mit deinem Netzwerk verbunden wird. Wir empfehlen das Host-Netzwerk. Der Container teilt sich dann das Netzwerk mit dem Host und verhält sich wie ein direkt installiertes Programm. Das hat mehrere Vorteile:

  • Beim Hinzufügen eines Geräts schlägt das Feld IP Adresse oder Hostname die in deinem Netzwerk gefundenen Geräte vor.
  • Funktionen auf Basis von mDNS stehen zur Verfügung, z. B. EEBUS, der SMA Sunny Home Manager und die automatische Erkennung durch die evcc-App.
  • Geräte, die über UDP kommunizieren, z. B. KEBA-Wallboxen und SMA-Geräte, sind ohne weitere Einrichtung erreichbar.
  • Es muss keine Portliste gepflegt werden. Eingehende Verbindungen, z. B. von OCPP-Wallboxen, funktionieren sofort.

Im Bridge-Netzwerk läuft der Container in einem separaten Docker-Netzwerk. Das ist in Ordnung, wenn du die oben genannten Funktionen nicht brauchst oder den Container lieber isolieren möchtest. Alle benötigten Ports musst du dann selbst freigeben. Geräte in deinem Netzwerk werden nicht vorgeschlagen, ihre Adressen trägst du von Hand ein.

Das Host-Netzwerk setzt einen Linux-Host voraus, dazu zählen auch die gängigen NAS-Systeme. Mit Docker Desktop unter macOS und Windows läuft der Container in einer virtuellen Maschine ohne direkten Zugriff auf dein Netzwerk. Nutze dort stattdessen die Installation für macOS oder Windows.

Der Container lässt sich über Docker Compose, die Docker CLI oder die Docker UI deines Systems einrichten. Alle drei Wege verwenden dasselbe Image und dieselben Volumes.

Es gibt zwei Image-Tags: evcc/evcc:latest (empfohlen) und evcc/evcc:nightly (Entwickler-Build).

Host-Pfad Container-Pfad Beschreibung Erforderlich
/home/user/.evcc /root/.evcc Verzeichnis für die Datenbank ja
/home/user/evcc.yaml /etc/evcc.yaml Konfigurationsdatei (nur wenn du eine verwendest) nein

Die Datenbank enthält deine Ladevorgänge und alles, was du in der Weboberfläche einrichtest. Lege das Verzeichnis vor dem ersten Start auf deinem Host-System an. Diese Anleitung verwendet als Beispiel /home/user/.evcc.

Das Volume für die evcc.yaml wird nur benötigt, wenn du deine Instanz über eine Konfigurationsdatei statt über die Weboberfläche einrichtest. Entferne die Zeile aus den folgenden Beispielen, wenn du keine verwendest.

Docker Compose ist der empfohlene Weg, da alle Parameter in einer Datei hinterlegt sind. Lege eine Datei mit dem Namen compose.yml und einer der folgenden Konfigurationen an:

services:
evcc:
container_name: evcc
image: evcc/evcc:latest
network_mode: host
volumes:
- /home/user/.evcc:/root/.evcc
- /home/user/evcc.yaml:/etc/evcc.yaml # optional
restart: unless-stopped

Starte den Container mit:

Terminal-Fenster
sudo docker compose up -d

Ob du sudo benötigst, hängt von deinem System ab.

Alternativ erstellst und startest du den Container mit einem einzelnen Befehl:

Terminal-Fenster
sudo docker run -d --name evcc \
--network host \
-v /home/user/.evcc:/root/.evcc \
-v /home/user/evcc.yaml:/etc/evcc.yaml \
--restart unless-stopped \
evcc/evcc:latest

Hat dein System eine Docker UI (z. B. Synology, QNAP, Portainer, Unraid), kannst du den Container dort erstellen. Trage das Image und die Volumes von oben ein und setze den Netzwerkmodus auf host. Wenn du stattdessen das Bridge-Netzwerk wählst, füge die benötigten Ports hinzu.

Die genauen Feldbezeichnungen sind von System zu System unterschiedlich. Die Konzepte Netzwerkmodus, Ports und Volumes findest du aber in allen Systemen wieder.

Ports müssen nur im Bridge-Netzwerk freigegeben werden. Im Host-Netzwerk sind diese Ports direkt auf dem Host verfügbar.

Host-Port Container-Port Beschreibung Erforderlich
7070 7070/tcp Weboberfläche, API ja
8887 8887/tcp OCPP-Server nein
9522 9522/udp SMA Sunny Home Manager nein
7090 7090/udp KEBA-Wallboxen nein
28376 28376/udp EVSE-Master-Wallboxen nein
5353 5353/udp mDNS nein
4712 4712/tcp EEBUS nein
8899 8899/udp Modbus UDP nein

Nach dem Start des Containers erreichst du die Weboberfläche unter http://<host>:7070. <host> ist die IP-Adresse oder der Hostname des Computers, auf dem der Container läuft.

Bei der ersten Verwendung wirst du aufgefordert, ein Administrator-Passwort festzulegen. Danach kannst du deine Geräte einrichten, wie unter Einrichtung beschrieben.

Solltest du keine Verbindung herstellen können, überprüfe die Logs deines Containers. Weitere Hilfe findest du in den GitHub Discussions.

Wechsle in das Verzeichnis mit der compose.yml und lade das neueste Image:

Terminal-Fenster
sudo docker compose pull

Falls ein neues Image vorhanden ist, erstellt der folgende Befehl den Container neu. Ansonsten läuft der bestehende weiter.

Terminal-Fenster
sudo docker compose up -d

Hier findest du von Nutzern erstellte Anleitungen für konkrete Systeme. Für die Richtigkeit und Aktualität können wir keine Gewähr übernehmen.

Auf einem Synology NAS kannst du evcc über Docker mit der grafischen Benutzeroberfläche installieren, ganz ohne Kommandozeile. Diese Anleitung verwendet das empfohlene Host-Netzwerk: Anleitung: Synology Docker (PDF)

Eine Anleitung für das Bridge-Netzwerk findest du hier: Anleitung: Synology Docker 2 (PDF) von at4hawo1

Die Installation von evcc auf einem QNAP NAS über die Container Station ähnelt stark der obigen Synology-Anleitung. QNAP-spezifische Hinweise findest du hier: Anleitung: QNAP (PDF)

Dies ist eine Option für Fortgeschrittene in kontrollierten Docker-Umgebungen, in denen das Bridge-Netzwerk gewollt ist und die Geräte feststehen. Die Umgebungsvariable EVCC_DISCOVERY_HOSTS stellt eine statische Liste von Geräten bereit. Diese Liste wird dann für die Vorschläge im Feld IP Adresse oder Hostname verwendet, statt das Netzwerk zu durchsuchen.

Der Wert ist eine JSON-Liste. Jeder Eintrag benötigt eine ip. hostname und mac sind optional. Sie werden verwendet, um den Hersteller anzuzeigen und Geräte, die zum gewählten Gerätetyp passen, unter Passend aufzuführen.

services:
evcc:
environment:
EVCC_DISCOVERY_HOSTS: >-
[
{"ip": "192.168.1.10", "hostname": "sma3009876543", "mac": "00:15:BB:12:34:56"},
{"ip": "192.168.1.20", "hostname": "go-echarger_123456"}
]

Eine leere Liste [] schaltet die Vorschläge ab.