Zum Hauptinhalt springen

Linux

Diese Anleitung beschreibt die Installation für apt-basierte Linux Distributionen wie Debian und Ubuntu.

Raspberry Pi

Für Raspberry Pi empfehlen wir die einfachere Installation mit evcc Linux Image.

hinweis

Für andere Linux Distributionen schau dir die Docker Anleitung oder den Manuelle Installation Abschnitt an.

Erstinstallation​

  • Öffne ein Terminal/Eingabeaufforderung

  • Installiere die benötigten Abhängigkeiten:

    sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl

  • Füge das evcc APT Repository hinzu:

Die aktuelle stabile Version

curl -1sLf 'https://dl.evcc.io/public/evcc/stable/setup.deb.sh' | sudo -E bash
hinweis

Hosted By: Cloudsmith

Wir bedanken uns bei Cloudsmith für das Hosting! Cloudsmith ist ein Service, welcher die Entwicklung von Software und Dienstleistungen für kostenlose und freie Plattformen ermöglicht.

  • Aktualisiere die Paketliste:

    sudo apt update

  • Installiere evcc:

    sudo apt install -y evcc

  • Starte den evcc-Server:

    sudo systemctl start evcc

  • Öffne die evcc Oberfläche in deinem Browser: http://localhost:7070

  • Die evcc Oberfläche fordert dich auf ein Administrator-Passwort zu vergeben

  • Anschließend kannst du deine Geräte direkt über die Weboberfläche einrichten

hinweis

Während der Installation wird ein Nutzer evcc angelegt, deshalb sollte der angemeldete Nutzer nicht den Namen evcc haben.

hinweis

Sollte eine serielle Schnittstelle verwendet werden kann es sein das dieser Befehl ausgeführt werden muss sudo usermod -a -G plugdev evcc. Dieser Befehl fügt den Benutzer evcc zur Gruppe plugdev hinzu. Die Gruppe plugdev dient dazu, Zugriffsrechte für Plug-in-Geräte (wie USB, serielle Schnittstelle usw.) zu erteilen, ohne dass Root-Rechte erforderlich sind.

Konfiguration​

evcc kann über die Weboberfläche oder eine Konfigurationsdatei eingerichtet werden.

Empfohlen

Die Konfiguration über die Weboberfläche ist der einfachste Weg, evcc einzurichten.

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 (traditionell)​

Alternativ kannst du eine evcc.yaml Konfigurationsdatei verwenden. Details zur Erstellung der Konfigurationsdatei findest du unter Einrichtung.

important

Die Konfigurationsdatei muss unter /etc/evcc.yaml abgelegt werden.

  • Erstelle die Konfigurationsdatei gemäß Anleitung und speichere sie unter /etc/evcc.yaml

  • Starte den evcc-Server neu:

    sudo systemctl restart evcc

  • Rufe die evcc Oberfläche auf http://localhost:7070

Aktualisierung​

Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte durch:

  • Prüfe Releases für Breaking changes (BC) die deine Installation betreffen

  • Öffne ein Terminal/Eingabeaufforderung

  • Aktualisiere den Paketbestand:

    sudo apt update

  • Installiere evcc:

    sudo apt --only-upgrade install -y evcc
info

Wenn das unstable Repository (Nightly Versionen) hinzugefügt wurde, wird beim Update immer auf die letzte verfügbare Nightly Version aktualisiert. Sollte das nicht mehr erwünscht sein, muss das unstable Repository mittels sudo rm /etc/apt/sources.list.d/evcc-unstable.list entfernt werden.

Downgrade​

Mit folgendem Befehl kann man auf eine ältere Version von evcc wechseln:

sudo apt install evcc=x.xxx.x # Versionsnummer

Systemdienst​

evcc läuft als Systemdienst im Hintergrund. Mit folgenden Befehlen kann dieser Dienst gesteuert werden.

sudo systemctl status evcc # zeigt den Status
sudo systemctl start evcc # startet den Dienst
sudo systemctl stop evcc # stoppt den Dienst
sudo systemctl restart evcc # startet den Dienst neu
sudo systemctl enable evcc # aktiviert den Dienst
sudo systemctl disable evcc # deaktiviert den Dienst

Testen​

Prüfe die Installation

  • Zeige den laufenden evcc Service an:

    sudo systemctl status evcc

  • Prüfe die letzten Log-Ausgaben des evcc Services:

    sudo journalctl -u evcc --since "yesterday"

  • Prüfe die evcc Meter-Konfiguration:

    sudo evcc -l debug meter

  • Prüfe die evcc Charger-Konfiguration:

    sudo evcc -l debug charger

  • Prüfe die evcc Vehicle-Konfiguration:

    sudo evcc -l debug vehicle

Öffne einen Browser und gib die folgende URL ein: http://127.0.0.1:7070.

hinweis

Ersetze 127.0.0.1 mit der IP Adresse oder dem Hostnamen des Computers, falls der Browser nicht auf dem gleichen Computer geöffnet wurde.

Backup und Restore​

Über die Weboberfläche (empfohlen)​

Die einfachste Methode ist das Backup über die Weboberfläche. Details findest du unter Einrichtung → Sichern & Wiederherstellen.

Manuelles Backup​

Um nach einer Neuinstallation wieder den "Ursprungszustand" herzustellen zu können, reicht es die Konfigurationsdatei evcc.yaml (falls verwendet) und die Datenbankdatei evcc.db zu sichern. Der Speicherort wird im Logfile beim Programmstart angegeben. Ü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 Homelaufwerk):

yaml kopieren: sudo cp /etc/evcc.yaml /home/pi/evcc.yaml.bak

db kopieren: sudo cp /var/lib/evcc/evcc.db /home/pi/evcc.db.bak

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 evcc

Beispiel​

/etc/systemd/system/evcc.service.d/override.conf
[Service]
Environment="EVCC_LOG=debug,tariff:trace"
ExecStart=
ExecStart=/usr/bin/evcc --custom-css /path/to/my.css
hinweis

Die erste leere ExecStart= Zeile ist wichtig, um den Standard-Befehl zu überschreiben.

tipp

Alle Parameter aus evcc.yaml können als Umgebungsvariable gesetzt werden: EVCC_ + Parametername in Großbuchstaben.

Eine vollständige Liste aller CLI-Optionen findest du in der CLI-Dokumentation.

Manuelle Installation​

Neben dem Debian/Ubuntu APT Paket, stellen wir auch weitere Binaries für Linux bereit.

Installation​

  • Lade die entsprechende Datei auf dein System herunter:

  • Entpacke die heruntergeladene Datei (z. B. per Doppelklick auf die Datei).

  • Im entpackten Ordner befindet sich ein evcc Programm.

  • Öffne ein Terminal und gehe in den Ordner neuen Ordner.

  • Mit folgendem Befehl kannst du prüfen, ob evcc funktioniert:

    ./evcc -v

  • Du solltest die aktuelle Version von evcc sehen (bspw. evcc version 0.xxx.y).

Konfiguration​

Du kannst evcc über die Weboberfläche oder eine Konfigurationsdatei einrichten. Details findest du unter Einrichtung.

Starte evcc mit:

./evcc

Öffne dann deinen Browser unter http://localhost:7070 und folge den Anweisungen.

Aktualisierung/Downgrade​

Führe die obigen Schritte aus und ersetze die evcc Programmdatei mit der neuen bzw. vorherigen Version. Die Konfiguration muss nicht erneut durchgeführt werden.

Service einrichten​

Im produktiven Einsatz möchtest du evcc als Systemdienst einrichten. Dieser sorgt dafür, dass evcc beim Starten des Computers ausgeführt wird. Außerdem wird evcc im Fehlerfall automatisch neu gestartet.

hinweis

Diese Dokumentation geht davon aus, dass Linux systemd unterstützt.

  • Führe folgenden Befehl aus, um einen Editor mit einer neuen Datei für den Dienst zu erstellen und zu öffnen:

    sudo nano /etc/systemd/system/evcc.service

  • Kopiere den folgenden Inhalt in die Datei

    [Unit]
    Description=evcc
    Requires=network-online.target
    After=syslog.target network.target network-online.target
    Wants=network-online.target
    StartLimitIntervalSec=10
    StartLimitBurst=10

    [Service]
    ExecStart=/usr/local/bin/evcc
    Restart=always
    RestartSec=5

    [Install]
    WantedBy=multi-user.target

    Passe den Pfad der evcc Datei in ExecStart an, falls die Datei in einem anderen Verzeichnis abgelegt ist. Dies geht auch davon aus, dass die Konfigurationsdatei evcc.yaml in /etc/evcc.yaml zu finden ist. Falls dies nicht der Fall ist, muss in ExecStart am Ende der Text -c /yourpath/evcc.yaml hinzugefügt werden. Der Text yourpath muss mit dem entsprechenden Verzeichnis ersetzt werden.

  • Teste den Dienst:

    sudo systemctl daemon-reload
    sudo systemctl start evcc
    sudo systemctl status evcc

    Die Ausgabe sollte bei Erfolg folgenden Text beinhalten: Active: active (running).

  • Konfiguriere den Dienst so, dass er beim Rechnerstart automatisch startet:

    sudo systemctl enable evcc.service

Weitere Informationen findest du oben im Abschnitt Systemdienst.