Windows

Hier findest du Anweisungen für die manuelle Installation von evcc auf Windows.

Achtung

Diese manuelle Installation erfordert fortgeschrittene PC Kenntnisse, vor allem auch im Umgang mit einem Terminal/Eingabeaufforderung.

Es ist auch möglich evcc auf Windows zu installieren. Allerdings wird evcc typischerweise in einer Linux-Umgebung (z.B. Raspberry Pi) verwendet.

Erstinstallation

1. Installieren

   Lade die passende Datei für dein System herunter und entpacke sie (z. B. per Doppelklick):

   • 64-Bit Intel CPU: evcc_X.XX_windows_amd64.zip

   Öffne ein Terminal/Eingabeaufforderung im entpackten Ordner und prüfe die Installation:

   evcc -v

   Du solltest nun die aktuelle Version von evcc sehen (z. B. evcc version 0.xxx.y).

2. Starten

   ./evcc

3. Einrichten

   Öffne die evcc Oberfläche in deinem Browser: http://localhost:7070. Vergib ein Administrator-Passwort und richte deine Geräte direkt über die Weboberfläche ein.

Konfigurationsdatei (alternativ)

Alternativ zur Weboberfläche kannst du eine evcc.yaml Konfigurationsdatei verwenden. Details zur Erstellung findest du unter Einrichtung.

Starte evcc mit:

./evcc -c evcc.yaml

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.

Hintergrunddienst

Aufgabenplanung

Hinweis

Diese Dokumentation geht davon aus, dass evcc in c:\evcc liegt.

Diese Anweisungen wurden mit Windows 10 erstellt.

• Beginne in der Suchleiste von Windows 10 mit der Eingabe des Wortes Aufgabenplanung. Bereits nach wenigen Buchstaben sollte diese als Treffer mit der höchsten Übereinstimmung angezeigt werden und kann auf der rechten Seite mit Als Administrator ausführen gestartet werden:

• Nach dem Start der Aufgabenplanung obliegt es dir, ob du den neuen Service in einem eigenen Ordner oder der allgemeinen Aufgabenplanungsbibliothek anlegst. Für dieses Beispiel wird ein eigener Ordner evcc angelegt. Hierzu muss zunächst der Ordner „Aufgabenplanungsbibliothek” angewählt werden, um dann mit der rechten Maustaste das Kontextmenü zu öffnen. Hier wählst du Neuer Ordner und benennst diesen evcc:

• Nun wählst du den neuen Ordner evcc oder die allgemeine Aufgabenplanungsbibliothek aus und öffnest erneut mit der rechten Maustaste das Kontextmenü. Dort wählst du Aufgabe erstellen:

• Als Name evcc und zur besseren Zuordnung sollte eine kurze Beschreibung mit angegeben werden. Da du den Service als Systemdienst laufen lässt, öffnest du die Userverwaltung über „Benutzer oder Gruppe ändern” und tippst dort system. Nach einem Klick auf User überprüfen sollte der Account angezeigt werden und der Dialog kann mit OK geschlossen werden:

• Einstellungen des Reiters Trigger: Aufgabe starten ändern auf „Beim Start” und prüfen, dass die Aufgabe aktiviert ist:

• Einstellungen des Reiters Aktionen: „Programm starten” belassen und über Durchsuchen die Datei evcc.exe auswählen. Es empfiehlt sich den Pfad zusätzlich in Starten in anzugeben, somit wird die dort abgelegte Konfigurationsdatei direkt gefunden:

• Einstellungen des Reiters Bedingungen: Diese Einstellungen können im Default belassen werden.

  Da z. B. der SMA Home Manager über WLAN Probleme bereiten kann, sollte optional der Haken bei Netzwerk gesetzt und eine entsprechende Verbindung ausgewählt werden.

• Einstellungen des Reiters Einstellungen: Den Haken bei Aufgabe so schnell wie möglich ... setzen. Unbedingt den Haken bei Aufgabe beenden, falls Ausführung länger als: entfernen, sonst wunderst du dich, dass evcc auf einmal nicht mehr läuft.

Die Aufgabe kann nun manuell gestartet oder über einen Reboot getestet werden. Zur Kontrolle mit dem Browser auf http://localhost:7070 zugreifen.

NSSM

Hinweis

Diese Dokumentation geht davon aus, dass evcc in c:\Tools\evcc liegt.

Diese Anweisungen wurden mit Windows 11 erstellt.

Als Alternative zur Aufgabenplanung kannst du evcc als Windows Dienst betreiben. Ein Dienst läuft ohne Benutzeranmeldung und bietet bessere Steuerungsmöglichkeiten für Neustart und Fehlerbehandlung.

Da evcc die Windows-Service-Schnittstelle nicht direkt unterstützt, kann nssm (Non-Sucking Service Manager) als Service Wrapper verwendet werden.

• Lade nssm von nssm.cc herunter und entpacke die ZIP-Datei nach C:\Tools\nssm\.

• Öffne eine Eingabeaufforderung (cmd.exe) und wechsle in den win64-Ordner:

  cd /D C:\Tools\nssm\nssm-2.24\win64

• Installiere den Dienst:

  nssm install evcc

• Gehe die Reiter des Dialogs durch. Die folgenden Einstellungen sind Empfehlungen.

  • Application:

    

    • Path: Pfad zur evcc.exe.
    • Start directory: Arbeitsverzeichnis für evcc.
    • Arguments: Parameter für evcc, z. B. -c evcc.yaml. Optional: --database evcc.db um den Datenbankpfad explizit zu setzen. Ohne diese Option liegt die Datenbank im Benutzerprofil des ausführenden Accounts. Beim System-Account wäre das %SystemRoot%\system32\config\systemprofile\.evcc\evcc.db — ein anderer Ort als bei interaktivem Start. Mit --database stellst du sicher, dass immer dieselbe Datenbank verwendet wird. Das ist relevant beim Passwort zurücksetzen.

  • Details:

    

    • Display Name: Name des Dienstes in der Diensteverwaltung (am besten identisch mit Service Name).
    • Startup type: Automatic für Autostart beim Booten.

  • Log on:

    

    Standard: Dienst läuft unter dem System-Account. Details: nssm-Dokumentation.

    Der hier gewählte Account bestimmt, wo evcc seine Datenbank evcc.db anlegt (siehe Arguments oben).

  • Dependencies:

    

    NlaSvc als Abhängigkeit stellt sicher, dass das Netzwerk bereit ist, bevor evcc startet.

  • Process:

    

    Standardeinstellungen beibehalten.

  • Shutdown:

    

    Standardeinstellungen beibehalten. nssm versucht evcc zuerst per Strg+C zu stoppen, dann per WM_CLOSE/WM_QUIT, und beendet den Prozess notfalls nach Timeout.

  • Exit actions:

    

    Empfehlung: Restart application mit 10 Sekunden Verzögerung, damit evcc nach einem Absturz oder Neustart über die Weboberfläche automatisch wieder startet.

  • I/O:

    

    Optional: stdout und stderr in Log-Dateien umleiten. Achte darauf, das Log-Level von evcc nicht zu hoch zu setzen, da die Dateien sonst schnell wachsen.

  • File rotation:

    

    Optional: Log-Rotation aktivieren, um die Grösse der Log-Dateien zu begrenzen.

  • Environment:

    

    Standardeinstellungen beibehalten.

Klicke auf Install Service um den Dienst einzurichten. Der Dienst kann anschliessend in der Windows-Diensteverwaltung gestartet und gestoppt werden. Zur Kontrolle mit dem Browser auf http://localhost:7070 zugreifen.