Přeskočit na obsah
chytré nabíjení

Docker

evcc lze nainstalovat jako obraz Dockeru. Obrazy jsou k dispozici pro AMD64, armv6 a arm64. Typickým použitím jsou systémy NAS jako Synology, QNAP, Unraid a TrueNAS.

Než kontejner vytvoříte, musíte se rozhodnout, jak bude připojen k vaší síti. Doporučujeme síťový režim host. Kontejner pak sdílí síť hostitele a chová se jako přímo nainstalovaný program. To má několik výhod:

  • Když přidáváte zařízení, pole IP adresa nebo název hostitele nabízí zařízení nalezená ve vaší síti.
  • Funkce založené na mDNS fungují, např. EEBUS, SMA Sunny Home Manager a automatické vyhledání v aplikaci evcc.
  • Zařízení komunikující přes UDP, např. nabíječky KEBA a zařízení SMA, jsou dostupná bez dalšího nastavování.
  • Není potřeba udržovat seznam portů. Příchozí spojení, např. od nabíječek OCPP, fungují hned.

V režimu bridge běží kontejner v samostatné síti Dockeru. To je v pořádku, pokud výše uvedené funkce nepotřebujete nebo chcete kontejner izolovat. Každý potřebný port pak musíte publikovat sami. Zařízení ve vaší síti se nenabízejí, takže jejich adresy zadáváte ručně.

Režim host vyžaduje linuxového hostitele, což zahrnuje i běžné systémy NAS. V aplikaci Docker Desktop na macOS a Windows běží kontejner ve virtuálním počítači bez přímého přístupu k vaší síti. Použijte tam místo toho instalaci pro macOS nebo Windows.

Kontejner lze nastavit pomocí Docker Compose, Docker CLI nebo grafického rozhraní Dockeru ve vašem systému. Všechny tři způsoby používají stejný obraz i svazky.

K dispozici jsou dva tagy obrazu: evcc/evcc:latest (doporučeno) a evcc/evcc:nightly (vývojová verze).

Cesta na hostiteli Cesta v kontejneru Popis Povinné
/home/user/.evcc /root/.evcc Adresář pro databázi ano
/home/user/evcc.yaml /etc/evcc.yaml Konfigurační soubor (jen pokud ho použijete) ne

Databáze obsahuje vaše nabíjecí relace a vše, co jste nastavili ve webovém rozhraní. Před prvním spuštěním vytvořte adresář na hostitelském systému. Tento návod používá jako příklad /home/user/.evcc.

Svazek evcc.yaml potřebujete jen tehdy, když svou instanci konfigurujete pomocí konfiguračního souboru místo webového rozhraní. Pokud ho nepoužíváte, odstraňte tento řádek z níže uvedených příkladů.

Docker Compose je doporučený způsob, protože všechny parametry jsou uloženy v jednom souboru. Vytvořte soubor compose.yml s jednou z následujících konfigurací:

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

Spusťte kontejner příkazem:

Terminál
sudo docker compose up -d

Zda potřebujete sudo, závisí na vašem systému.

Kontejner můžete také vytvořit a spustit jediným příkazem:

Terminál
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

Grafické rozhraní Dockeru

Sekce “Grafické rozhraní Dockeru”

Pokud má váš systém grafické rozhraní pro Docker (např. Synology, QNAP, Portainer, Unraid), můžete kontejner vytvořit v něm. Zadejte obraz a svazky uvedené výše a nastavte síťový režim na host. Pokud místo toho zvolíte režim bridge, přidejte potřebné porty.

Přesné názvy polí se systém od systému liší. Pojmy síťový režim, porty a svazky ale najdete ve všech.

Publikování portů je nutné jen v režimu bridge. V režimu host jsou tyto porty dostupné přímo na hostiteli.

Port hostitele Port kontejneru Popis Povinné
7070 7070/tcp Webové rozhraní, API ano
8887 8887/tcp Server OCPP ne
9522 9522/udp SMA Sunny Home Manager ne
7090 7090/udp Nabíječky KEBA ne
28376 28376/udp Nabíječky EVSE Master ne
5353 5353/udp mDNS ne
4712 4712/tcp EEBUS ne
8899 8899/udp Modbus UDP ne

Po spuštění kontejneru je webové rozhraní dostupné na adrese http://<host>:7070. <host> je IP adresa nebo název hostitele počítače, na kterém kontejner běží.

Při prvním použití budete vyzváni k nastavení hesla administrátora. Poté můžete nastavit svá zařízení podle popisu v části Konfigurace.

Pokud se nedaří navázat spojení, zkontrolujte logy kontejneru. Další pomoc najdete v GitHub Discussions.

Přejděte do adresáře se souborem compose.yml a stáhněte nejnovější obraz:

Terminál
sudo docker compose pull

Pokud je k dispozici nový obraz, následující příkaz kontejner znovu vytvoří. Jinak poběží dál stávající kontejner.

Terminál
sudo docker compose up -d

Zde najdete návody pro konkrétní systémy, které vytvořili uživatelé. Nemůžeme zaručit, že jsou správné nebo aktuální.

evcc můžete na systémech Synology NAS nainstalovat přes Docker pomocí grafického rozhraní, bez použití příkazové řádky. Tento návod používá doporučený režim host: Anleitung: Synology Docker (PDF / DE)

Návod pro režim bridge najdete zde: Anleitung: Synology Docker 2 (PDF / DE) od at4hawo1

Instalace evcc na systémech QNAP přes Container Station je velmi podobná výše uvedenému návodu pro Synology. Návod specifický pro QNAP najdete zde: Anleitung: QNAP (PDF / DE)

Statické návrhy zařízení

Sekce “Statické návrhy zařízení”

Jde o pokročilou možnost pro spravovaná prostředí Dockeru, kde je záměrně použit režim bridge a zařízení se nemění. Proměnná prostředí EVCC_DISCOVERY_HOSTS poskytuje statický seznam zařízení. Tento seznam se pak místo prohledávání sítě použije pro návrhy v poli IP adresa nebo název hostitele.

Hodnota je seznam ve formátu JSON. Každá položka potřebuje ip. hostname a mac jsou volitelné. Slouží k zobrazení výrobce a k zařazení zařízení odpovídajících zvolenému typu do skupiny Odpovídající.

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"}
]

Prázdný seznam [] návrhy vypne.