Linux
Diese Anleitung beschreibt die Installation für APT-basierte Linux-Distributionen wie Debian und Ubuntu.
Erstinstallation
Abschnitt betitelt „Erstinstallation“-
Installieren
Abschnitt betitelt „Installieren“Öffne ein Terminal und installiere die benötigten Abhängigkeiten:
Terminal-Fenster sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curlFüge das evcc-APT-Repository hinzu:
Aktuelle stabile Version
Terminal-Fenster curl -1sLf 'https://dl.evcc.io/public/evcc/stable/setup.deb.sh' | sudo -E bashEntwicklungsversion. Täglich aktualisiert. Kann instabil sein.
Terminal-Fenster curl -1sLf 'https://dl.evcc.io/public/evcc/unstable/setup.deb.sh' | sudo -E bashAktualisiere die Paketliste und installiere evcc:
Terminal-Fenster sudo apt updatesudo apt install -y evcc -
Starten
Abschnitt betitelt „Starten“Terminal-Fenster sudo systemctl start evcc -
Einrichten
Abschnitt betitelt „Einrichten“Öffne die evcc-Weboberfläche in deinem Browser: http://localhost:7070. Vergib ein Administrator-Passwort und richte deine Geräte direkt über die Weboberfläche ein.
Wir bedanken uns bei Cloudsmith für das Hosting des Repositorys!
Konfiguration
Abschnitt betitelt „Konfiguration“evcc kann über die Weboberfläche oder eine Konfigurationsdatei eingerichtet werden.
Weboberfläche (empfohlen)
Abschnitt betitelt „Weboberfläche (empfohlen)“Nach dem ersten Start kannst du evcc direkt im Browser unter http://localhost:7070 konfigurieren. Die Einstellungen werden automatisch in der Datenbank gespeichert.
Konfigurationsdatei (klassisch)
Abschnitt betitelt „Konfigurationsdatei (klassisch)“Alternativ kannst du eine Konfigurationsdatei evcc.yaml verwenden.
Details zur Erstellung der Konfigurationsdatei findest du unter Einrichtung.
-
Erstelle die Konfigurationsdatei gemäß der Anleitung und speichere sie unter
/etc/evcc.yaml -
Starte den evcc-Server neu:
Terminal-Fenster sudo systemctl restart evcc -
Rufe die evcc-Weboberfläche unter http://localhost:7070 auf
Aktualisierung
Abschnitt betitelt „Aktualisierung“Um auf die neueste Version von evcc zu aktualisieren, führe folgende Schritte aus:
-
Prüfe die Releases auf Breaking Changes (BC), die deine Installation betreffen
-
Öffne ein Terminal
-
Aktualisiere die Paketliste:
Terminal-Fenster sudo apt update -
Aktualisiere evcc:
Terminal-Fenster sudo apt --only-upgrade install -y evcc
Downgrade
Abschnitt betitelt „Downgrade“Falls du aus irgendeinem Grund auf eine ältere Version zurückwechseln musst, geht das mit diesem Befehl:
sudo apt install evcc=x.xxx.x # VersionsnummerSystemdienst
Abschnitt betitelt „Systemdienst“evcc läuft als Systemdienst im Hintergrund. Mit diesen Befehlen kannst du den Dienst steuern:
sudo systemctl status evcc # zeigt den Statussudo systemctl start evcc # startet den Dienst, falls er noch nicht läuftsudo systemctl stop evcc # stoppt den Dienstsudo systemctl restart evcc # startet den Dienst neusudo systemctl enable evcc # startet den Dienst automatisch beim Bootensudo systemctl disable evcc # deaktiviert den automatischen Start beim BootenSo prüfst du die Installation:
-
Zeige den laufenden evcc-Dienst an:
Terminal-Fenster sudo systemctl status evcc -
Prüfe die letzten Log-Einträge des evcc-Dienstes:
Terminal-Fenster sudo journalctl -u evcc --since "yesterday" -
Prüfe die Konfiguration der Zähler:
Terminal-Fenster sudo evcc -l debug meter -
Prüfe die Konfiguration der Wallbox:
Terminal-Fenster sudo evcc -l debug charger -
Prüfe die Konfiguration der Fahrzeuge:
Terminal-Fenster sudo evcc -l debug vehicle
Öffne einen Browser und gib die folgende URL ein: http://127.0.0.1:7070.
Sichern und Wiederherstellen
Abschnitt betitelt „Sichern und Wiederherstellen“Über die Weboberfläche (empfohlen)
Abschnitt betitelt „Über die Weboberfläche (empfohlen)“Am einfachsten erstellst du eine Sicherung über die Weboberfläche. Details findest du unter Konfiguration → Sichern & Wiederherstellen.
Manuelle Sicherung
Abschnitt betitelt „Manuelle Sicherung“Um nach einer Neuinstallation den bisherigen Zustand wiederherzustellen, reicht es, die Konfigurationsdatei evcc.yaml (falls verwendet) und die Datenbankdatei evcc.db zu sichern.
Der Speicherort wird beim Programmstart im Log ausgegeben.
Üblicherweise liegt die Konfiguration unter /etc/evcc.yaml und die Datenbank unter /var/lib/evcc/evcc.db.
Beide Dateien können mit dem Linux-Befehl cp kopiert werden.
Beispiel (Kopieren vom üblichen Speicherort ins Home-Verzeichnis):
Konfigurationsdatei kopieren: sudo cp /etc/evcc.yaml /home/pi/evcc.yaml.bak
Datenbank kopieren: sudo cp /var/lib/evcc/evcc.db /home/pi/evcc.db.bak
Umgebungsvariablen & CLI-Optionen
Abschnitt betitelt „Umgebungsvariablen & CLI-Optionen“Bei der Installation über APT läuft evcc als systemd-Dienst. Du kannst das Verhalten über eine Override-Datei anpassen:
sudo systemctl edit evccBeispiel
Abschnitt betitelt „Beispiel“[Service]Environment="EVCC_LOG=debug,tariff:trace"Environment="EVCC_DATABASE_DSN=/usb/evcc/evcc.db"Environment="EVCC_NETWORK_HOST=my-evcc.local"Environment="EVCC_NETWORK_PORT=80"ExecStart=ExecStart=/usr/bin/evcc --custom-css /path/to/my.cssManuelle Installation
Abschnitt betitelt „Manuelle Installation“Neben dem APT-Paket für Debian/Ubuntu stellen wir auch weitere Binaries für Linux bereit.
Installation
Abschnitt betitelt „Installation“-
Lade die passende Datei für dein System herunter:
- 64-Bit-Intel-CPU: evcc_X.XX_linux_amd64.tar.gz
- 64-Bit-ARM-CPU: evcc_X.XX_linux_arm64.tar.gz
- 32-Bit-ARM-CPU (z. B. Raspberry Pi mit 32-Bit-OS): evcc_X.XX_linux_armv6.tar.gz
-
Entpacke die heruntergeladene Datei (z. B. per Doppelklick).
-
Im entpackten Ordner befindet sich ein Programm
evcc. -
Öffne ein Terminal und wechsle in den neuen Ordner.
-
Mit folgendem Befehl kannst du prüfen, ob evcc funktioniert:
./evcc -v -
Du solltest die aktuelle Version von evcc sehen (z. B.
evcc version 0.xxx.y).
Konfiguration
Abschnitt betitelt „Konfiguration“Du kannst evcc über die Weboberfläche oder eine Konfigurationsdatei einrichten. Details findest du unter Einrichtung.
Starte evcc mit:
./evccÖffne dann http://localhost:7070 in deinem Browser und folge den Anweisungen.
Aktualisierung/Downgrade
Abschnitt betitelt „Aktualisierung/Downgrade“Führe die obigen Schritte aus und ersetze die evcc-Programmdatei durch die neue bzw. vorherige Version. Die Konfiguration muss nicht erneut durchgeführt werden.
Dienst einrichten
Abschnitt betitelt „Dienst einrichten“Im produktiven Einsatz solltest du evcc als Systemdienst einrichten. So startet evcc beim Hochfahren des Computers und wird im Fehlerfall automatisch neu gestartet.
-
Führe folgenden Befehl aus, um eine neue Datei für den Dienst anzulegen und im Editor zu öffnen:
Terminal-Fenster sudo nano /etc/systemd/system/evcc.service -
Kopiere den folgenden Inhalt in die Datei:
[Unit]Description=evccRequires=network-online.targetAfter=syslog.target network.target network-online.targetWants=network-online.targetStartLimitIntervalSec=10StartLimitBurst=10[Service]ExecStart=/usr/local/bin/evccRestart=alwaysRestartSec=5[Install]WantedBy=multi-user.targetPasse den Pfad der Datei
evccinExecStartan, falls die Datei in einem anderen Verzeichnis liegt. Außerdem wird davon ausgegangen, dass die Konfigurationsdateievcc.yamlunter/etc/evcc.yamlliegt. Falls nicht, ergänze am Ende vonExecStartden Text-c /yourpath/evcc.yaml. Ersetzeyourpathdurch das entsprechende Verzeichnis. -
Teste den Dienst:
Terminal-Fenster sudo systemctl daemon-reloadsudo systemctl start evccsudo systemctl status evccBei Erfolg sollte die Ausgabe Folgendes enthalten:
Active: active (running). -
Richte den Dienst so ein, dass er beim Systemstart automatisch startet:
Terminal-Fenster sudo systemctl enable evcc.service
Weitere Informationen findest du oben im Abschnitt Systemdienst.