Zum Inhalt

LubeLogger per Docker als digitales Fahrzeugheft einrichten

Veröffentlicht am 22. August 2026 · Geschätzte Lesezeit: 4 Minuten

LubeLogger verwaltet Wartungen, Reparaturen, Tankvorgänge, Kosten und Erinnerungen für deine Fahrzeuge. Die Daten bleiben auf deinem eigenen Server und liegen dauerhaft in Docker-Volumes. Installation und Grundabsicherung dauern ungefähr 15 Minuten.

Voraussetzungen

  • Ein Server mit Docker und Docker Compose
  • Der Port 8080 ist im Heimnetz frei
  • Eine feste IP-Adresse für den Server
  • Ein langes Passwort für das spätere Root-Konto

1. Arbeitsordner anlegen

Führe den Befehl auf deinem Docker-Server aus:

mkdir -p ~/docker/lubelogger && cd ~/docker/lubelogger

2. Compose-Datei anlegen

Lege im neuen Ordner eine Datei compose.yaml mit folgendem Inhalt an:

services:
  lubelogger:
    image: ghcr.io/hargata/lubelogger:latest
    container_name: lubelogger
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - lubelogger-data:/App/data
      - lubelogger-keys:/root/.aspnet/DataProtection-Keys

volumes:
  lubelogger-data:
    name: lubelogger-data
  lubelogger-keys:
    name: lubelogger-keys

lubelogger-data enthält Datenbank, Einstellungen und hochgeladene Dokumente. Das zweite Volume bewahrt die Datenschutzschlüssel der Anwendung auf. Beide gehören ins Backup.

3. Konfiguration prüfen und starten

Prüfe die Compose-Datei im Projektordner:

docker compose config --quiet

Lade das Image und starte den Container:

docker compose pull

docker compose up -d

Kontrolliere, ob der Container läuft:

docker compose ps

Bei einem Fehler zeigen die Protokolle weitere Hinweise:

docker compose logs --tail=100 lubelogger

4. Sprache und Einheiten festlegen

Öffne http://<server-ip>:8080 im Browser. Ersetze <server-ip> durch die feste IP-Adresse deines Servers. Öffne Settings und danach den Server Settings Configurator. Wähle eine passende Locale, Datumsdarstellung und metrische Einheiten.

Änderungen an Server-Einstellungen werden erst nach einem Neustart wirksam:

docker compose restart lubelogger

5. Anmeldung sofort aktivieren

Öffne Settings, aktiviere Enable Authentication und vergib Benutzername und ein langes Passwort für den Root-Benutzer. Melde dich anschließend neu an.

Ohne Anmeldung sind Fahrzeugdaten offen

LubeLogger startet standardmäßig ohne aktivierte Authentifizierung. Aktiviere sie, bevor andere Geräte oder Netze den Dienst erreichen können. Aktiviere keine offene Registrierung, wenn du sie nicht ausdrücklich benötigst.

Leite Port 8080 nicht im Router weiter. Für externen Zugriff verwende einen HTTPS-Reverse- Proxy oder ein privates VPN.

6. Erstes Fahrzeug und Erinnerung anlegen

Öffne Garage und lege ein Fahrzeug mit Baujahr, Hersteller und Modell an. Trage danach unter Odometer den aktuellen Kilometerstand ein. Erstelle unter Reminders eine Erinnerung, zum Beispiel für den nächsten Ölwechsel nach Datum oder Kilometerstand.

Keine unnötigen persönlichen Daten

Kennzeichen, Fahrgestellnummern und Rechnungen sind für viele Auswertungen nicht erforderlich. Speichere nur Informationen, die du wirklich benötigst.

7. Backup in LubeLogger erstellen

Melde dich als Root-Benutzer an. Öffne Settings und klicke auf Make Backup. Lade das erzeugte ZIP-Archiv herunter und bewahre es außerhalb des Docker-Servers auf.

Das Anwendungsbackup ist der einfachste Rückweg, weil LubeLogger es über Restore Backup wieder einlesen kann. Teste regelmäßig, ob sich das ZIP-Archiv öffnen lässt.

8. Docker-Volumes zusätzlich sichern

Stoppe den Container für eine konsistente Kopie:

docker compose stop lubelogger

Lege einen Backup-Ordner an:

mkdir -p backup

Sichere das Daten-Volume:

docker run --rm -v lubelogger-data:/data:ro -v "$PWD/backup:/backup" alpine sh -c 'tar czf /backup/lubelogger-data-$(date +%F).tar.gz -C /data .'

Sichere danach auch das Schlüssel-Volume:

docker run --rm -v lubelogger-keys:/data:ro -v "$PWD/backup:/backup" alpine sh -c 'tar czf /backup/lubelogger-keys-$(date +%F).tar.gz -C /data .'

Starte LubeLogger wieder:

docker compose start lubelogger

9. Aktualisieren und zurückkehren

Erstelle zuerst ein LubeLogger-Backup und prüfe die Volumes. Aktualisiere danach:

docker compose pull

docker compose up -d

Wenn Daten nach einem Update fehlen, stoppe weitere Eingaben und stelle das zuvor erzeugte ZIP-Backup über Settings → Restore Backup wieder her. Bei einem Containerproblem kannst du außerdem vorübergehend den vorherigen Versions-Tag aus den offiziellen Releases nutzen.

10. Typische Fehler

  • Port 8080 ist belegt: Prüfe mit sudo ss -ltnp | grep ':8080' und ändere bei Bedarf nur die linke Zahl, zum Beispiel auf 8081:8080.
  • Einstellungen ändern sich nicht: Starte den Container nach Server-Einstellungen neu.
  • Daten verschwinden nach Neuerstellung: Prüfe, ob beide benannten Volumes in compose.yaml weiterhin eingetragen sind.
  • Falsche Dezimal- oder Datumsdarstellung: Wähle im Server Settings Configurator eine andere passende Locale.

11. Quellen und Videos

Fertig

LubeLogger läuft nun geschützt im Heimnetz. Melde dich unter http://<server-ip>:8080 an und prüfe, ob dein Fahrzeug, der Kilometerstand und die erste Wartungserinnerung nach einem Container-Neustart weiterhin vorhanden sind.