Zum Inhalt springen
Smart laden

macOS

Diese Anleitung beschreibt die Installation unter macOS (10.12 und höher) mit dem Paketmanager Homebrew.

  1. Öffne ein Terminalfenster und installiere Homebrew, falls es noch nicht installiert ist.

    Terminal-Fenster
    brew trust --tap evcc-io/tap
    brew tap evcc-io/tap
    brew update
    brew install --cask evcc
  2. evcc wird als Homebrew-Cask ausgeliefert, der sich nicht mit brew services verwalten lässt. Lege stattdessen einen launchd-Agenten an. Er startet evcc bei der Anmeldung und startet es neu, falls es beendet wird:

    Terminal-Fenster
    mkdir -p "$(brew --prefix)/var/log"
    cat > ~/Library/LaunchAgents/io.evcc.plist <<EOF
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
    <key>Label</key>
    <string>io.evcc</string>
    <key>ProgramArguments</key>
    <array>
    <string>$(brew --prefix)/bin/evcc</string>
    </array>
    <key>WorkingDirectory</key>
    <string>$(brew --prefix)</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>$(brew --prefix)/var/log/evcc.log</string>
    <key>StandardErrorPath</key>
    <string>$(brew --prefix)/var/log/evcc.log</string>
    </dict>
    </plist>
    EOF
    launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/io.evcc.plist
  3. Öffne die Weboberfläche in deinem Browser: http://localhost:7070. Lege ein Administrator-Passwort fest und richte deine Geräte direkt über die Weboberfläche ein.

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

Alternativ kannst du eine Konfigurationsdatei evcc.yaml unter /etc/evcc.yaml verwenden. Details findest du unter Einrichtung.

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

  • Öffne ein Terminalfenster.

  • Aktualisiere die Paketlisten:

    Terminal-Fenster
    brew update
  • Aktualisiere evcc:

    Terminal-Fenster
    brew upgrade --cask evcc
  • Starte evcc neu:

    Terminal-Fenster
    launchctl kickstart -k gui/$(id -u)/io.evcc

Bis Version 0.314.5 wurde evcc als Homebrew-Formula ausgeliefert und mit brew services gestartet. Homebrew stellt eine installierte Formula nicht auf einen Cask um, daher meldet brew upgrade die alte Version weiterhin als aktuell. Entferne die Formula einmalig und installiere den Cask:

Terminal-Fenster
brew services stop evcc
brew uninstall evcc
brew update
brew install --cask evcc

Lege anschließend den launchd-Agenten wie unter Starten beschrieben an. Deine Konfiguration und Datenbank bleiben davon unberührt.

  • Prüfe den Status deiner evcc-Instanz:

    Terminal-Fenster
    launchctl print gui/$(id -u)/io.evcc
  • Stoppe evcc und entferne den launchd-Agenten:

    Terminal-Fenster
    launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/io.evcc.plist
  • Zeige die Logs an:

    Terminal-Fenster
    tail -f "$(brew --prefix)/var/log/evcc.log"

Hier findest du die Anleitung für die manuelle Installation von evcc unter macOS.

  • Lade die passende Datei auf dein System herunter:
  • Entpacke die heruntergeladene Datei (z. B. per Doppelklick auf die Datei).
  • Es gibt nun einen neuen Ordner mit dem Programm evcc.
  • Öffne ein Terminalfenster und wechsle in den Ordner mit dem Programm evcc.
  • Starte evcc mit folgendem Befehl:
    Terminal-Fenster
    ./evcc -v
  • Du solltest die aktuelle Version von evcc sehen (z. B. evcc version 0.xxx.y).

Öffne nach dem ersten Start http://localhost:7070 im Browser und richte evcc über die Weboberfläche ein.

Alternativ kannst du eine Konfigurationsdatei evcc.yaml erstellen (siehe Einrichtung) und evcc damit starten:

Terminal-Fenster
./evcc -c evcc.yaml

Führe die obigen Schritte aus und ersetze die evcc-Programmdatei durch die neue bzw. vorherige Version. Die Konfiguration muss nicht erneut vorgenommen werden.