Du nutzt EVCC als praktisches Home Assistant Add-on für intelligentes PV-Überschussladen, aber plötzlich stehst du vor einer gesperrten Anmeldemaske: Admin-Passwort vergessen, verlegt oder nach einer Neuinstallation ausgesperrt? Keine Panik! In dieser Schritt-für-Schritt-Anleitung zeige ich dir, wie du das Passwort in wenigen Minuten über die Konsole zurücksetzt.
Inhaltsverzeichnis
Wer sein Elektroauto zu Hause mit eigenem Solarstrom laden möchte, landet früher oder später bei EVCC (Electric Vehicle Charge Controller). Als Home Assistant Add-on ist die Software genial integriert. Doch die Sache hat einen Haken, wenn man die Admin-Zugangsdaten der Web-Oberfläche verliert: In der GUI von Home Assistant gibt es keinen einfachen „Passwort vergessen“-Button für Add-on-Inhalte.
Nachdem ich selbst einige Zeit an Recherche und Fehlversuchen investiert habe, zeige ich dir hier den direkten, funktionierenden Weg.
Die Hürde: Warum Standard-Anleitungen oft scheitern
In der offiziellen EVCC-Dokumentation liest man häufig den Befehl evcc password reset. Führst du diesen jedoch einfach irgendwo im Home-Assistant-Terminal aus, passiert entweder gar nichts oder der Befehl schlägt fehl.
Das hat zwei Gründe:
EVCC läuft innerhalb eines abgeschotteten Docker-Containers.
Die Datenbank liegt im Add-on nicht im Standardpfad (
~/.evcc/evcc.db), sondern fest gemountet unter/data/evcc.db.
Um das Passwort erfolgreich zurückzusetzen, müssen wir also direkt in den laufenden Container hinein und den Pfad zur Datenbank explizit mitgeben.
Voraussetzung: Terminal mit Root-Zugriff
Damit wir auf die Docker-Ebene von Home Assistant zugreifen können, reicht das Standard-Terminal nicht aus.
Gehe in Home Assistant auf Einstellungen → Add-ons → Add-on Store.
Installiere das Add-on Advanced SSH & Web Terminal (aus dem Community Add-on Store).
Sehr wichtig: Öffne die Einstellungen des Add-ons und deaktiviere den „Geschützten Modus“ (Protection Mode). (Hinweis: Ohne diesen Schritt hat das Terminal keine Berechtigung, mit dem Docker-Daemon zu kommunizieren.)
Starte das Terminal-Add-on und öffne das Web-Interface.
Schritt-für-Schritt: EVCC Admin-Passwort zurücksetzen
Schritt 1: EVCC-Container-Namen ermitteln
Sobald du im Terminal bist, prüfen wir mit docker ps, welche Container aktuell laufen:
docker ps
In der Ausgabe suchst du nach der Zeile mit dem EVCC-Image. Das sieht in etwa so aus:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
cfdda9b6deb6 evcc/evcc:0.313.2 "/app/entrypoint.sh …" 8 minutes ago Up 8 minutes (healthy) app_49686a9f_evcc
Wichtig: Notiere dir den Namen in der Spalte
NAMES. Bei Home Assistant Add-ons lautet dieser meistapp_49686a9f_evccoder beginnt mitaddon_....
Schritt 2: In den EVCC-Container wechseln
Nun verbinden wir uns interaktiv direkt in die Shell des laufenden EVCC-Containers:
docker exec -it app_49686a9f_evcc sh
(Ersetze app_49686a9f_evcc durch deinen tatsächlichen Containernamen, falls er abweicht.)
Dein Prompt wechselt nun zu /app #. Du befindest dich jetzt direkt im EVCC-Dateisystem.
Schritt 3: Speicherort der SQLite-Datenbank prüfen
EVCC speichert Einstellungen, Tokens und Benutzerdaten in einer SQLite-Datenbank. Prüfe kurz mit ls, ob die Datei im Ordner /data liegt:
ls -l /data
Erwartete Ausgabe:
total 2600
-rw-r--r-- 1 root root 2658304 Aug 22 18:30 evcc.db
-rw------- 1 root root 74 Aug 22 21:22 options.json
Liegt dort die evcc.db, haben wir genau den richtigen Speicherort gefunden.
Schritt 4: Passwort-Befehl prüfen (optional)
Wenn du wissen möchtest, welche Flags EVCC für die Passwort-Verwaltung anbietet, kannst du die Hilfe aufrufen:
evcc password --help
Du siehst hier die Sub-Commands reset und set sowie die Option --database, die für uns entscheidend ist.
Schritt 5: Admin-Passwort zurücksetzen
Jetzt führen wir den Reset durch. Wir weisen EVCC explizit an, die Datenbank unter /data/evcc.db zu verwenden:
evcc password reset --database /data/evcc.db
EVCC gibt daraufhin Log-Meldungen aus und fragt dich um Bestätigung:
[main ] INFO 2026/08/22 21:32:42 config file not found, database-only mode
[main ] INFO 2026/08/22 21:32:42 using sqlite database: /data/evcc.db?_pragma=busy_timeout(5000)&_pragma=foreign_keys(1)&_pragma=auto_vacuum(INCREMENTAL)
? Are you sure? Yes
Tippe Y (oder wähle mit Enter Yes) und bestätige. Das bisherige Passwort ist damit gelöscht!
Schritt 6: Container verlassen und Add-on neu starten
Verlasse zunächst die Container-Shell:
exit
Damit EVCC die Änderungen sauber lädt, startest du den Container einmal neu. Das geht entweder direkt im Terminal:
docker restart app_49686a9f_evcc
Alternativ: Gehe in Home Assistant auf Einstellungen → Add-ons → EVCC und klicke auf Neu starten.
Fertig! Was passiert als Nächstes?
Wenn du die EVCC-Weboberfläche in Home Assistant nun wieder aufrufst, ist die vorherige Passwortsperre aufgehoben:
Ohne Kennwort: Du gelangst wieder direkt in das Dashboard und die Konfigurationseinstellungen.
Neues Passwort festlegen: Du kannst nun in den EVCC-Einstellungen direkt über die Oberfläche ein neues, sicheres Kennwort vergeben (oder im Terminal per
evcc password set --database /data/evcc.db).
Vergiss nicht, das neue Passwort diesmal direkt in deinem Passwortmanager zu speichern!
Fazit
Man muss das Add-on nicht deinstallieren oder die Konfiguration komplett neu aufsetzen, nur weil das Login-Passwort verloren ging. Mit dem richtigen Zugriff auf die Container-Shell und dem Verweis auf /data/evcc.db ist das Problem in unter fünf Minuten gelöst.
Hast du Fragen zur Konfiguration oder betreibst du dein PV-Überschussladen mit einer speziellen Wallbox? Schreib es gerne unten in die Kommentare!
Nein. EVCC arbeitet aus Sicherheits- und Datenschutzgründen komplett lokal. Es gibt standardmäßig keinen angebundenen Mailserver für Passwort-Reset-Links. Der Hash des Kennworts wird direkt in der lokalen SQLite-Datenbank hinterlegt, weshalb das Zurücksetzen nur über die Kommandozeile (CLI) funktioniert.
Das passiert fast immer aus einem von zwei Gründen:
Falsches Terminal-Add-on: Du nutzt das Standard-Terminal von Home Assistant statt Advanced SSH & Web Terminal.
Geschützter Modus aktiv: Im Add-on Advanced SSH & Web Terminal ist der Schalter Geschützter Modus (Protection Mode) noch aktiv. Schalte ihn in den Add-on-Einstellungen aus und starte das Terminal neu – erst dann erhält die Konsole Zugriff auf die Docker-Schnittstelle.
Nein, deine Daten sind sicher. Der Befehl evcc password reset leert lediglich den Passworteintrag in der internen Tabelle. Sämtliche Konfigurationen zu Wallbox, Wechselrichter, PV-Überschussregeln sowie deine aufgezeichneten Ladehistorien in der evcc.db bleiben unberührt.
Standardmäßig sucht die EVCC-Binary nach einer Datenbank unter ~/.evcc/evcc.db. Im Home Assistant Add-on ist der persistente Speicher jedoch fest auf den Ordner /data/ gemountet. Ohne die explizite Angabe --database /data/evcc.db läuft der Befehl ins Leere oder erstellt eine leere Dummy-Datei am falschen Ort.
Je nach Home Assistant Installation und Add-on-Version kann der Containername variieren (z. B. addon_49686a9f_evcc). Du findest den exakten Namen mit folgendem Befehl:
docker ps | grep evcc
Nutze für docker exec und docker restart einfach den Bezeichner, der in der Spalte ganz rechts unter NAMES angezeigt wird (oder alternativ die 12-stellige CONTAINER ID).
Ja. Wenn du das Kennwort nicht erst in der Weboberfläche neu setzen möchtest, nutzt du innerhalb des Containers den Befehl:
evcc password set --database /data/evcc.db
EVCC fordert dich anschließend interaktiv zur zweifachen Eingabe deines neuen Wunschkennworts auf.
