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.

Síťový režim

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.

Instalace

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

Svazky

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

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í:

Režim host (doporučeno)
Režim bridge

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

services:
  evcc:
    container_name: evcc
    image: evcc/evcc:latest
    ports:
      - 7070:7070/tcp
      - 8887:8887/tcp
    volumes:
      - /home/user/.evcc:/root/.evcc
      - /home/user/evcc.yaml:/etc/evcc.yaml # optional
    restart: unless-stopped

Tento příklad publikuje jen webové rozhraní a server OCPP. Další porty přidejte podle potřeby.

Spusťte kontejner příkazem:

sudo docker compose up -d

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

Docker CLI

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

Režim host (doporučeno)
Režim bridge

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

sudo docker run -d --name evcc \
  -p 7070:7070 \
  -p 8887:8887 \
  -v /home/user/.evcc:/root/.evcc \
  -v /home/user/evcc.yaml:/etc/evcc.yaml \
  --restart unless-stopped \
  evcc/evcc:latest

Tento příklad publikuje jen webové rozhraní a server OCPP. Další porty přidejte podle potřeby.

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.

Porty

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

Ověření

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.

Aktualizace

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

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.

sudo docker compose up -d

Stáhněte nejnovější obraz a poté zastavte a odstraňte stávající kontejner:

sudo docker pull evcc/evcc:latest
sudo docker stop evcc
sudo docker rm evcc

Kontejner znovu spusťte stejným příkazem docker run jako při instalaci.

Návody od komunity

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

Synology NAS

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

QNAP NAS

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í

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.