Zum Inhalt springen
Smart laden

Linux

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

  1. Öffne ein Terminal und installiere die benötigten Abhängigkeiten:

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

    Fü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 bash

    Aktualisiere die Paketliste und installiere evcc:

    Terminal-Fenster
    sudo apt update
    sudo apt install -y evcc
  2. Terminal-Fenster
    sudo systemctl start evcc
  3. Ö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.

Hosted By: Cloudsmith

Wir bedanken uns bei Cloudsmith für das Hosting des Repositorys!

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

Nach dem ersten Start kannst du evcc direkt im Browser unter http://localhost:7070 konfigurieren. Die Einstellungen werden automatisch in der Datenbank gespeichert.

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

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

Falls du aus irgendeinem Grund auf eine ältere Version zurückwechseln musst, geht das mit diesem Befehl:

Terminal-Fenster
sudo apt install evcc=x.xxx.x # Versionsnummer

evcc läuft als Systemdienst im Hintergrund. Mit diesen Befehlen kannst du den Dienst steuern:

Terminal-Fenster
sudo systemctl status evcc # zeigt den Status
sudo systemctl start evcc # startet den Dienst, falls er noch nicht läuft
sudo systemctl stop evcc # stoppt den Dienst
sudo systemctl restart evcc # startet den Dienst neu
sudo systemctl enable evcc # startet den Dienst automatisch beim Booten
sudo systemctl disable evcc # deaktiviert den automatischen Start beim Booten

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

Am einfachsten erstellst du eine Sicherung über die Weboberfläche. Details findest du unter Konfiguration → Sichern & Wiederherstellen.

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

Bei der Installation über APT läuft evcc als systemd-Dienst. Du kannst das Verhalten über eine Override-Datei anpassen:

Terminal-Fenster
sudo systemctl edit evcc
/etc/systemd/system/evcc.service.d/override.conf
[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.css

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

  • Lade die passende Datei für dein System herunter:

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

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

Starte evcc mit:

Terminal-Fenster
./evcc

Öffne dann http://localhost:7070 in deinem Browser und folge den Anweisungen.

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.

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=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 Datei evcc in ExecStart an, falls die Datei in einem anderen Verzeichnis liegt. Außerdem wird davon ausgegangen, dass die Konfigurationsdatei evcc.yaml unter /etc/evcc.yaml liegt. Falls nicht, ergänze am Ende von ExecStart den Text -c /yourpath/evcc.yaml. Ersetze yourpath durch das entsprechende Verzeichnis.

  • Teste den Dienst:

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

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