Lademonitor

Lademonitor

Docker app from iDomi94's Repository

Selbstgehostete Ladevorgang-Tracking-App fuer E-Autos (z.B.

Requirements

Internet-Zugriff optional fuer Adresssuche (Nominatim) beim Anlegen von Ladeorten
Overview
Selbstgehostete Ladevorgang-Tracking-App fuer E-Autos (z.B. Skoda Enyaq via MySkoda/Home-Assistant-Integration), inspiriert von Spritmonitor. Backend, Web-UI und PostgreSQL laufen zusammen in diesem einen Container - kein separater DB-Container noetig.

Lademonitor

Sprache: Deutsch | English

License: AGPL v3

Selbstgehostete Ladevorgang-Tracking-App für ein E-Auto (Škoda Enyaq via MySkoda/Home-Assistant-Integration), inspiriert von Spritmonitor. Läuft komplett selbstgehostet, kein Cloud-Dienst.

Zugehörige iOS-App (SwiftUI, reiner REST-Client gegen dieses Backend): Lademonitor-App – öffentliche Beta über TestFlight: testflight.apple.com/join/NMbyFTEK

Features

  • Home Assistant: Lademonitor-HA (HACS-Integration) holt Statistik-Sensoren (Kosten/Verbrauch/km) in HA und überträgt automatisch erkannte Ladevorgänge per Service statt manuellem rest_command-Token-Handling – deutlich einfacher als der rohe API-Weg unten. Für HA OS/Supervised gibt es zusätzlich Lademonitor-HA-Addon, um den Server direkt als Add-on statt separat (z.B. auf Unraid) zu betreiben.
  • Ladevorgänge manuell erfassen oder automatisch per Home-Assistant-Automation pushen lassen (POST /api/sessions/auto)
  • MyŠkoda Public API: alternativ erkennt der Server Ladevorgänge selbst, indem er die offizielle Škoda-API direkt abfragt – ganz ohne Home Assistant. Nur API-Key und FIN eintragen, siehe Automatische Ladeerkennung
  • BMW CarData: für BMW und MINI liest der Server die Ladehistorie direkt bei BMW, mit gemessenen kWh, siehe Ladehistorie von BMW
  • VW-Konzern (EU Data Act): für Volkswagen, Audi, Škoda, SEAT, Cupra, Bentley und VW Nutzfahrzeuge liest der Server das Datenportal des Konzerns und erkennt daraus die Ladevorgänge (kWh geschätzt wie bei MyŠkoda), siehe VW-Datenportal
  • Renault und Dacia (My Renault): der Server fragt dieselbe Schnittstelle ab wie die My-Renault-App und erkennt daraus die Ladevorgänge, siehe Renault und Dacia
  • Verbrauchsberechnung (kWh/100km) pro Ladevorgang über eine priorisierte Fallback-Kette (Vollladungs-Intervalle als Goldstandard, SoC-Korrektur, naive Rechnung, Schätzung) – Details in CLAUDE.md
  • Ladeorte per Adresssuche anlegen (Nominatim) oder automatisch per Offline-Reverse-Geocoding einen Anzeigetext zu GPS-Koordinaten ermitteln
  • Spritmonitor-CSV-Import mit Vorschau und Duplikat-Erkennung
  • Vollständiger Backup-Export/-Import als ZIP (alle Fahrzeuge, Anbieter, Ladeorte, Ladevorgänge), gedacht für Server-Neuaufsetzung
  • Mehrbenutzerfähig: Registrierung, Login (mit Nutzername oder E-Mail-Adresse), jeder Nutzer hat einen eigenen, komplett isolierten Datensatz
  • E-Mail: SMTP-Zugang in den Einstellungen hinterlegen, dann gibt es „Passwort vergessen", Einladungen für neue Konten und Benachrichtigungen – bei fehlgeschlagenem Backup, bei abgelaufenem MyŠkoda-API-Key, als Sammelmeldung über zu prüfende Ladevorgänge und als Monatsbericht. Jede Meldung ist pro Nutzer abschaltbar.
  • Verbrauch nach Außentemperatur (seit 0.23.0): Streudiagramm aller Fahrten über der Temperatur, mit Mittelwert je 5-°C-Klasse und Ausgleichsgerade – darüber als Kennzahl, wie viel mehr das Fahrzeug bei 0 °C braucht als bei 20 °C, dazu ein Vergleich der Jahreszeiten. Die Temperatur liefert Home Assistant (ab Lademonitor-HA 0.5.0) oder man trägt sie von Hand ein.
  • Reifen (seit 0.26.0): Reifenwechsel mit Art, Datum, Kilometerstand, Größe, Marke und Modell eintragen – ab dem Datum gilt der Satz, bis der nächste Eintrag folgt. Daraus eine Übersicht (wie lange ein Satz aufgezogen war, Kilometer, Fahrten, Alter seit der ersten Montage; Wiedermontagen desselben Satzes in einer Zeile) und der Vergleich, welcher Satz mehr braucht – temperaturbereinigt, denn ein roher Vergleich der Saison-Durchschnitte würde nur messen, dass Winterreifen im Winter gefahren werden. Fehlt beiden Sätzen ein gemeinsamer Temperaturbereich, steht der Hochrechnungs-Hinweis über der Tabelle.
  • Kartenansicht (seit 0.20.0) über die eigenen Ladeorte (mit Matching-Radius) und alle Ladevorgänge mit Koordinaten, mit Clustern, Vorschau und Legende als Filter. Leaflet liegt lokal im Image, nur die Kartenkacheln kommen von OpenStreetMap – dazu gibt es einen Hinweis unter der Karte und einen Abschnitt in der Datenschutzerklärung.
  • Als App installierbar: die Web-Oberfläche bringt ein Web-App-Manifest mit und lässt sich zum Startbildschirm hinzufügen (eigenes Fenster statt Browser-Tab). Bewusst ohne Zwischenspeicher, damit ein Update sofort durchschlägt.
  • Server-rendertes Web-UI (kein separates Frontend-Build nötig), reine REST-API für Home Assistant, die iOS-App und die Android-App (eigene Repos)

Start / Installation

Vier Deployment-Wege – je nachdem, wo/wie der Server laufen soll. Backend, Web-UI und Postgres stecken in allen vier Varianten im selben Container (außer Docker Compose, siehe unten) – kein separater DB-Container nötig.

Unraid (Community Applications)

Am einfachsten für Unraid-Nutzer: in Apps nach "Lademonitor" suchen und installieren. Das Template (templates/lademonitor-server.xml) ist vorkonfiguriert (Port, /config-Pfad für die Daten) und zeigt auf das öffentliche GHCR-Image, das per GitHub Actions automatisch gebaut wird (siehe .github/workflows/docker-publish.yml). Über den Tag-Selector im Container-Edit lässt sich statt latest (stabil) auch beta (jeweils aktuellster main-Stand) wählen.

Home Assistant Add-on

Für HA OS/Supervised, um den Server direkt in Home Assistant statt separat zu betreiben: Einstellungen → Add-ons → Add-on-Store → ⋮ → Repositories, dort https://github.com/iDomi94/Lademonitor-HA-Addon eintragen, dann "Lademonitor" installieren und starten. Daten liegen im Supervisor-/data- Pfad und sind damit Teil regulärer HA-Backups. Details im Add-on-Repo.

Zugriff (Ingress-Sidebar-Button oder Direktport 8111) funktioniert dabei nur lokal im Heimnetz – für externen Zugriff (z.B. die iOS-App unterwegs) brauchst du zusätzlich einen VPN-Zugang zu deinem Netz oder einen eigenen Reverse-Proxy/Nginx-Vhost auf Port 8111 (Details dazu im Add-on-Repo).

Docker (Einzelcontainer)

Für jeden anderen Docker-Host (Synology, VPS, Unraid ohne CA, …), ein Container statt Stack:

docker run -d -p 8111:8000 -v /pfad/zu/daten:/config ghcr.io/idomi94/lademonitor-server:latest

/config enthält die komplette Postgres-Datenbank – unbedingt in den Backup-Plan aufnehmen. Optional zusätzlich -e FIELD_ENCRYPTION_KEY=... setzen, um GPS-Koordinaten/Notizen in der Datenbank zu verschlüsseln – sinnvoll, sobald der Server öffentlich erreichbar ist, fürs reine Heimnetz nicht nötig. Erzeugen lässt sich ein gültiger Schlüssel z.B. mit (reine Python-Standardbibliothek, kein pip install nötig):

python3 -c "import base64, os; print(base64.urlsafe_b64encode(os.urandom(32)).decode())"

Details siehe Sicherheitshinweis.

Docker Compose (lokale Entwicklung/Tests)

Einziger Weg mit zwei getrennten Containern (Backend + Postgres), gedacht für Entwicklung/Tests statt Produktivbetrieb:

docker compose up -d --build

Web-UI danach unter http://<host-ip>:8111. Zugangsdaten für die interne Postgres-Instanz lassen sich optional per .env überschreiben (siehe .env.example) – der Compose-interne Standard ist unkritisch, da Postgres nicht nach außen exponiert wird. FIELD_ENCRYPTION_KEY in derselben .env ist ebenfalls optional, siehe Sicherheitshinweis.

Tests

Laufen ohne Container gegen ein SQLite-in-memory:

pip install -r backend/requirements.txt -r backend/requirements-dev.txt
cd backend && python -m pytest

Bei jedem Push und Pull Request läuft derselbe Lauf über .github/workflows/tests.yml. Nicht abgedeckt sind die Datenbank-Migrationen (run_light_migrations(), bewusst Postgres-eigenes SQL) – die weiterhin gegen eine Kopie der echten Datenbank prüfen, siehe CLAUDE.md.


API-Dokumentation (Swagger) liegt unter /docs.

Erste Schritte

  1. Account registrieren (/register) – der erste registrierte Nutzer wird automatisch Admin.
  2. Unter Einstellungen dein Fahrzeug anlegen (External ID z.B. enyaq – wird 1:1 in der Home-Assistant-Automation wiederverwendet).
  3. Optional: Ladeanbieter mit bekannten Preisen und bekannte Ladeorte anlegen.
  4. Unter Import eine Spritmonitor-CSV hochladen, oder unter Ladevorgänge manuell erfassen.
  5. Auf dem Dashboard Kosten-/Verbrauchsstatistiken ansehen.

Home-Assistant-Anbindung

Empfehlung: Statt der rohen API unten die Lademonitor-HA-Integration (über HACS) nutzen – übernimmt Login/Token-Handling und bringt fertige Services für den automatischen Push mit, inkl. einer vollständigen Beispiel-Automation in deren README.

POST /api/sessions/auto nimmt automatisch erkannte Ladevorgänge entgegen (erwartet einen Authorization: Bearer <token>-Header – Token per POST /api/auth/login holen, siehe CLAUDE.md für ein Beispiel-Package mit rest_command-Automation). Direkter API-Zugriff bleibt für andere Integrationen/Skripte natürlich weiterhin möglich. Erwartetes JSON:

{
  "vehicle_external_id": "enyaq",
  "external_session_id": "20260809_1432",
  "start_time": "2026-08-09T14:05:00",
  "end_time": "2026-08-09T14:32:00",
  "soc_start": 42,
  "soc_end": 89,
  "odometer_km": 48213,
  "latitude": 52.5200,
  "longitude": 13.4050
}

Die external_session_id verhindert Duplikate, falls die Automation mehrfach feuert. Sessions über diesen Weg werden mit source: automatic und needs_review: true markiert und, falls die Koordinaten zu einem bekannten Ladeort passen, automatisch mit Anbieter/Preis vorbefüllt.

Optionale Felder (alle dürfen fehlen): charging_type (ac/dc), energy_kwh mit energy_meter (charger/vehicle, z.B. aus dem Energiezähler der Wallbox), outside_temp_c und – seit v0.41.0 für die Heimladung mit PV-Anlage/Hausakku – grid_energy_kwh (davon aus dem Netz bezogen, der Rest kam von der Sonne bzw. aus dem Hausakku) und price_total (gemessene Kosten des Vorgangs, z.B. bei zeitabhängigem Tarif). Ist price_total gesetzt, ersetzt es den Preis aus dem Preis-Gedächtnis des Anbieters (Preis je kWh = price_total / energy_kwh); der zuletzt gemerkte Anbieterpreis bleibt dabei unverändert. Ein grid_energy_kwh über energy_kwh wird auf energy_kwh gekappt. Die Ladevorgangsliste zeigt den Sonnenanteil dann als „☀ 78 % Sonne“ unter den Kosten.

{
  "energy_kwh": 21.4,
  "energy_meter": "charger",
  "grid_energy_kwh": 4.7,
  "price_total": 1.41
}

Automatische Ladeerkennung über die MyŠkoda Public API

Zweite, von Home Assistant unabhängige Quelle für automatisch erfasste Ladevorgänge – gedacht für alle, die kein Home Assistant betreiben. Der Server fragt die offizielle MyŠkoda Public API selbst ab, erkennt Beginn und Ende eines Ladevorgangs aus den Zustands- übergängen und legt ihn wie einen HA-Push mit source: automatic und needs_review: true an.

Einrichtung (Einstellungen → Automatische Ladeerkennung):

  1. API-Key in der MyŠkoda-App erzeugen: go.skoda.eu/api-keys (Link auf dem Handy öffnen). Der Key ist an die beim Erzeugen ausgewählten Fahrzeuge gebunden und läuft nach einiger Zeit ab.
  2. Fahrzeug auswählen, API-Key und FIN (17 Zeichen) eintragen, speichern.
  3. "Verbindung testen" zeigt die geparste Antwort der API – das ist gleichzeitig die Kontrolle, welche Felder das eigene Fahrzeug überhaupt liefert.
  4. "Automatisch abfragen" aktivieren.

Wichtig zu wissen:

  • Mehrere automatische Quellen für ein Fahrzeug sind seit 0.46.0 erlaubt: die später kommende ergänzt den vorhandenen Vorgang (überlappende Ladezeit), statt einen zweiten anzulegen.
  • Rate-Limit: 20 Anfragen pro Stunde und API-Key, geteilt über alle Fahrzeuge und alle Clients. Die Standardintervalle (20 min im Leerlauf, 5 min während eines Ladevorgangs) bleiben mit Reserve darunter. Läuft parallel die MySkoda-PublicAPI-Integration in Home Assistant mit demselben Key, teilen sich beide dieses Kontingent – dann besser einen zweiten Key erzeugen.
  • Genauigkeit: Die API kennt keinen Push und keinen Energiezähler. Der Ladebeginn wird erst beim nächsten Abruf bemerkt, der Anfangs-SoC ist also eher zu hoch und die Energie eher zu niedrig – bei AC-Laden vernachlässigbar, bei DC-Schnellladen deutlich spürbar. Jeder erkannte Vorgang bekommt deshalb eine Notiz mit den Werten davor und danach.
  • Debug-Protokoll: Unter derselben Sektion; protokolliert jede Abfrage und jede Erkennungsentscheidung inklusive der vollständigen Rohantworten und lässt sich als JSON herunterladen. Da das Antwortverhalten der API (noch in der Beta) während eines echten Ladevorgangs kaum dokumentiert ist, ist das der Weg, eine nicht erkannte Ladung nachträglich aufzuklären.
  • Der API-Key liegt im Klartext in der Datenbank (wie alle Zugangsdaten dieser App), wird aber bewusst nicht in die Backup-ZIP exportiert.

Vorerst nur über die Web-UI konfigurierbar; die Endpunkte (/api/myskoda/...) sind trotzdem regulärer Teil der REST-API und in /docs dokumentiert.

Ladehistorie von BMW (BMW CarData)

Für BMW und MINI gibt es eine dritte automatische Quelle: die offizielle BMW CarData API. BMW liefert dort abgeschlossene Ladevorgänge mit Start, Ende, Ladestand, km-Stand, Position und der aus dem Netz bezogenen Energie. Lademonitor legt daraus Ladevorgänge an (immer „zu prüfen“); die kWh gelten als gemessen.

  1. Im MyBMW-Portal unter dem Fahrzeug den Punkt BMW CarData öffnen, eine Client-ID erzeugen und den Zugang CarData API beantragen.
  2. In der MyBMW-App prüfen, dass du Hauptnutzer des Fahrzeugs bist.
  3. In Lademonitor unter Einstellungen → API & Debug → „Ladehistorie von BMW“ die Client-ID eintragen und Mit BMW verbinden drücken. Auf der BMW-Seite den angezeigten Code bestätigen. Die FIN wird danach automatisch ergänzt.
  4. Schalter „Automatischer Abruf“ einschalten.

Hinweise:

  • BMW erlaubt 50 Anfragen am Tag je Konto. Lademonitor nutzt höchstens 40 davon und fragt standardmäßig alle 4 Stunden ab. Ladevorgänge erscheinen also mit Verzögerung.
  • Die Anmeldung bleibt gültig, solange mindestens alle zwei Wochen abgerufen wird. Läuft sie ab, kommt eine Mail.
  • Mehrere automatische Quellen für ein Fahrzeug sind seit 0.46.0 erlaubt: die später kommende ergänzt den vorhandenen Vorgang (überlappende Ladezeit), statt einen zweiten anzulegen.
  • Client-ID und Tokens werden nicht in die Backup-ZIP exportiert.

VW-Konzern: Datenportal nach EU Data Act

Für alle Marken des VW-Konzerns außer Porsche (Volkswagen, VW Nutzfahrzeuge, Audi, Škoda, SEAT, Cupra, Bentley) gibt es eine vierte automatische Quelle: das Datenportal, in dem jeder Halter nach EU Data Act seine Fahrzeugdaten abrufen kann. Das Portal stellt alle 15 Minuten einen Datensatz bereit; Lademonitor erkennt daraus wie bei MyŠkoda Einstecken, Laden und Ausstecken. Die kWh gelten als geschätzt: der Energiezähler des Portals ist im Fahrzeug aus dem SoC gerechnet.

  1. Im Portal mit dem Konto der Marke anmelden (Cupra ID, Škoda-Konto, VW ID usw.) und für das Fahrzeug eine fortlaufende Datenanfrage All Data anlegen.
  2. In Lademonitor unter Einstellungen → API & Debug → „VW-Konzern“ Fahrzeug, Marke, E-Mail-Adresse und Passwort eintragen und Verbindung testen drücken. Die FIN wird ergänzt, wenn genau ein Fahrzeug freigegeben ist.
  3. Schalter „Automatischer Abruf“ einschalten.

Hinweise:

  • Es gibt keine offizielle Schnittstelle. Der Server meldet sich wie ein Browser an (nachgebaut nach den MIT-lizenzierten Projekten HA_VAG-EU-Data-Act und carconnectivity-connector-vw-eu-data-act). Ändert VW die Anmeldeseite, bricht der Abruf, bis Lademonitor angepasst ist.
  • Verlangt VW die Zustimmung zu neuen Nutzungsbedingungen, einmal im Browser im Portal anmelden und zustimmen. Lademonitor stimmt nie selbst zu.
  • Das Portal liefert keine Position. Ladeort und Anbieter trägst du beim Prüfen nach.
  • Daten kommen nur, wenn das Fahrzeug wach ist; Lücken von Stunden sind normal. Ein verpasster Ladevorgang wird über den Sprung im Ladestand nachträglich erkannt.
  • Die Datenanfrage läuft nach rund zwölf Monaten ab. Dann kommt eine Mail, und im Portal muss eine neue angelegt werden.
  • E-Mail, Passwort und FIN werden verschlüsselt gespeichert (mit FIELD_ENCRYPTION_KEY), nie angezeigt und nicht in die Backup-ZIP exportiert.
  • Mehrere automatische Quellen für ein Fahrzeug sind seit 0.46.0 erlaubt: die später kommende ergänzt den vorhandenen Vorgang (überlappende Ladezeit), statt einen zweiten anzulegen.
  • Die kWh gelten als geschätzt: der Energiezähler des Portals ist aus dem SoC gerechnet.

Renault und Dacia (My Renault)

Fünfte automatische Quelle, für Renault und Dacia mit My-Renault-Konto (z.B. Zoe, Megane E-Tech, Scenic E-Tech, Renault 5, Dacia Spring). Lademonitor spricht dieselbe Schnittstelle wie die My-Renault-App und die Home-Assistant-Integration renault (nachgebaut nach der MIT-lizenzierten Bibliothek renault-api) und erkennt wie bei MyŠkoda Einstecken, Laden und Ausstecken.

  1. In Lademonitor unter Einstellungen → API & Debug → „Renault und Dacia“ Fahrzeug, Land, E-Mail-Adresse und Passwort des My-Renault-Kontos eintragen und Anmelden drücken.
  2. Verlangt Renault einen Bestätigungscode, kommt er per E-Mail; ihn in das eingeblendete Feld eintragen.
  3. Verbindung testen drücken. Die FIN wird ergänzt, wenn genau ein Fahrzeug im Konto ist.
  4. Schalter „Automatischer Abruf“ einschalten.

Hinweise:

  • Es gibt keine offizielle Schnittstelle. Ändert Renault die Anmeldung, bricht der Abruf, bis Lademonitor angepasst ist. Noch nicht mit einem echten Konto getestet.
  • Renault erlaubt rund 60 Anfragen je Stunde und Konto, geteilt mit der App und Home Assistant. Standard ist ein Abruf alle 15 Minuten ohne Kabel und alle 5 Minuten mit Kabel.
  • Die kWh werden aus dem Ladestand geschätzt; Kilometerstand, Position und Außentemperatur kommen mit, sofern das Modell sie liefert.
  • Die Anmeldung bleibt gespeichert, ein Neustart fragt nicht erneut nach dem Code. Verlangt Renault im laufenden Betrieb einen neuen Code, kommt eine Mail.
  • E-Mail, Passwort, Anmeldung und FIN werden verschlüsselt gespeichert (mit FIELD_ENCRYPTION_KEY), nie angezeigt und nicht in die Backup-ZIP exportiert.
  • Mehrere automatische Quellen für ein Fahrzeug sind seit 0.46.0 erlaubt: die später kommende ergänzt den vorhandenen Vorgang (überlappende Ladezeit), statt einen zweiten anzulegen.

Backup

Drei Ebenen:

  • Eingebauter Export/Import (Einstellungen → Daten-Backup): ZIP mit CSVs aller eigenen Daten, ideal für eine Server-Neuinstallation.
  • Automatisches WebDAV-Backup (Einstellungen → Automatisches WebDAV-Backup): lädt genau diese ZIP in konfigurierbarer Häufigkeit (täglich/wöchentlich/monatlich) automatisch auf einen WebDAV-Server hoch (z.B. Nextcloud) und räumt dort selbst hochgeladene Backups nach der eingestellten Aufbewahrungsfrist wieder auf. Pro Nutzer konfigurierbar, läuft im Hintergrund ohne Cron/externen Scheduler.
  • Rohes Volume-Backup: Bei Compose liegt die DB unter ./data/postgres, beim Einzelcontainer unter dem gemounteten /config-Pfad – für Unraid reicht ein regelmäßiger Ordner-Backup-Job (z.B. CA Backup/Restore Appdata).

Sicherheitshinweis

Auth ist eingebaut (Registrierung/Login, pro Nutzer isolierte Daten). Passwörter liegen bcrypt-gehasht in der Datenbank, Anmelde-Tokens als SHA-256-Hash.

Es gibt bewusst noch kein Rate-Limiting auf Login/Registrierung – bei öffentlicher Erreichbarkeit über einen Reverse Proxy also auf ein starkes Passwort achten. („Passwort vergessen" ist begrenzt, weil es Mails auslöst.)

Zum SMTP-Passwort: es muss im Klartext gespeichert werden, weil SMTP es beim Anmelden überträgt – aus einem Hash ließe es sich nicht zurückgewinnen. Verwende deshalb ein app-spezifisches Passwort oder ein eigenes Absender-Konto: wird es geleakt, kann jemand in deinem Namen Mails schicken, kommt aber nicht an dein Postfach. Über die API wird es nie zurückgegeben und in die Backup-ZIP kommt es ebenfalls nicht (wie der MyŠkoda-API-Key – nach einer Neuinstallation also neu eintragen).

Beim Zurücksetzen oder Ändern des Passworts werden alle Geräte abgemeldet. Home Assistant und die iOS-App brauchen danach einen neuen Token.

Verschlüsselung personenbezogener Daten (optional): Wird FIELD_ENCRYPTION_KEY gesetzt (siehe oben), liegen GPS-Koordinaten (Ladeorte und Ladevorgänge, inkl. eines evtl. gerade laufenden, noch nicht abgeschlossenen MyŠkoda-Ladevorgangs), Notizen, Fahrzeug-/Ladeort-Namen, die Fahrzeug-Identifizierungsnummer (VIN), die kompletten Rohantworten der MyŠkoda-API (Debug-Protokoll) sowie die gespeicherten Zugangsdaten (SMTP-, WebDAV-Adresse/-Nutzername/-Passwort, MyŠkoda-API-Key) verschlüsselt in der Datenbank statt im Klartext. Standardmäßig aus – wer den Server nur im eigenen Heimnetz betreibt, braucht das nicht; sinnvoll, sobald er öffentlich erreichbar ist (z.B. eigener Reverse Proxy). Ob sie gerade aktiv ist, zeigt ein Badge unten in den Einstellungen. Schützt gegen Diebstahl von DB-Dump/Backup/Datenträger. Kein Zero-Knowledge-Schutz: Der Schlüssel liegt im Server-Environment, der Server entschlüsselt weiterhin transparent bei jedem Request – wer den laufenden Server-Prozess kontrolliert, kommt technisch an die Daten. Der eingebaute CSV-Export und das automatische WebDAV-Backup liefern alle verschlüsselten Werte bewusst weiterhin im Klartext (portables, menschenlesbares Format) – landet dieses Backup auf fremder Infrastruktur, greift die Verschlüsselung dort nicht. Bewusst NICHT verschlüsselt (SQL-Gleichheitsvergleiche bzw. Eindeutigkeits-Prüfungen brauchen dafür Klartext): Fahrzeug-external_id (HA-Push), Anbieter-Name, Nutzername und E-Mail-Adresse. Einmal aktiviert und benutzt nicht mehr deaktivieren (Schlüssel entfernen) – ohne ihn sind die damit verschlüsselten Werte nicht mehr lesbar, der Server startet dann absichtlich nicht mehr. Details in CLAUDE.md, Abschnitt "Verschlüsselung personenbezogener Daten".

Datenschutzerklärung: liegt unter /privacy, öffentlich erreichbar und im Footer verlinkt. Verantwortlich im Sinne der DSGVO ist der Betreiber der jeweiligen Installation – trage dafür PRIVACY_CONTROLLER_NAME, PRIVACY_CONTROLLER_ADDRESS und PRIVACY_CONTROLLER_EMAIL ein (siehe .env.example). Ohne diese Angaben zeigt die Seite einen deutlichen Warnhinweis statt unvollständiger Angaben – spätestens vor einer öffentlichen Erreichbarkeit nachtragen.

Details und weitere bekannte Einschränkungen in CLAUDE.md.

Nach einem Update nicht erreichbar?

Falls der Server nach einem Rebuild/Update über deinen eigenen Reverse Proxy (z.B. Nginx vor Unraid) kurzzeitig nicht erreichbar ist und erst nach Leeren des Browser-Caches wieder geht, sind typischerweise zwei Ursachen möglich:

  • Browser-Cache: Der Browser zeigt noch eine vor dem Update geladene Seite (altes HTML/JS) an, die nicht mehr zum neuen Server passt. Seit v0.9.1 senden die HTML-Seiten Cache-Control: no-store, damit Browser sie grundsätzlich nicht mehr zwischenspeichern – ein Hard-Refresh (Strg/Cmd+Shift+R) sollte das Problem seitdem nicht mehr auslösen.
  • Reverse Proxy/Docker-Netzwerk: Ein Container-Rebuild vergibt meist eine neue interne Docker-IP. Falls dein Nginx den Zielserver einmalig auflöst und die IP danach nicht neu ermittelt (üblich bei einem statischen upstream-Eintrag ohne dynamische DNS-Auflösung), zeigt er nach einem Rebuild auf die alte, nicht mehr existierende IP – hilft dann ein Neuladen/Neustart des Reverse-Proxy-Containers, nicht das Leeren des Browser-Caches, ist das die wahrscheinlichere Ursache.

Ein secure-Cookie-Problem (siehe CLAUDE.md) ist es bei einem bereits laufenden HTTPS-Setup nicht – das betrifft nur den direkten HTTP-Zugriff ohne eigenen Reverse Proxy.

Weiterführende Doku

CLAUDE.md enthält die vollständige Architektur-Dokumentation (Datenmodell, Auth-Design, Verbrauchsberechnung, Deployment-Details) – Startpunkt für alles, was hier nicht Platz findet.

Categories

Related apps

Links

Details

Repository
ghcr.io/idomi94/lademonitor-server:latest
Last Updated2026-11-20
First Seen2026-08-24

Runtime arguments

Web UI
http://[IP]:[PORT:8000]/
Network
bridge
Shell
bash
Privileged
false

Template configuration

WebUI PortPorttcp

Port fuer Web-UI und REST-API (z.B. fuer die Home-Assistant-Automation oder die iOS-App)

Target
8000
Default
8111
Value
8111
DatenPathrw

Enthaelt die komplette Postgres-Datenbank (alle Fahrzeuge/Ladevorgaenge) - unbedingt in den regulaeren Backup-Plan aufnehmen. Zusaetzlich gibt es einen eigenen Export/Import (Einstellungen -&gt; Daten-Backup) fuer portable CSV-Backups.

Target
/config
Default
/mnt/user/appdata/lademonitor
Value
/mnt/user/appdata/lademonitor
Verschluesselungsschluessel (optional)Variable

Optional: aktiviert die Verschluesselung von GPS-Koordinaten und Notizen in der Datenbank - leer lassen, wenn der Server nur im eigenen Heimnetz laeuft, empfohlen sobald er oeffentlich erreichbar ist (z.B. eigener Reverse Proxy). Erzeugen z.B. mit 'python3 -c &quot;import base64, os; print(base64.urlsafe_b64encode(os.urandom(32)).decode())&quot;' und SICHER AUFBEWAHREN (z.B. Passwort-Manager) - NICHT im Daten-Pfad oben ablegen, sonst landet er im selben Backup wie die verschluesselten Daten. Einmal gesetzt und benutzt nicht mehr entfernen - verloren bzw. entfernt bedeutet, dass die damit verschluesselten Felder nicht mehr lesbar sind.

Target
FIELD_ENCRYPTION_KEY