Installationsanleitung für Windows 11

So läuft deine Installation ab

Diese Anleitung führt Schritt für Schritt durch die Installation von AutoLogbuch auf einem eigenen Windows-11-PC als Satellit — angebunden an die eine bereits bestehende Zentrale-Installation — praktisch zum Ausprobieren oder als dauerhafte Lösung, wenn der Rechner ohnehin durchläuft. Genutzt wird Docker Desktop mit grafischer Oberfläche; nur für ein paar Befehle wird kurz ein PowerShell-Fenster gebraucht.

Einfacher: nativer Installer

Kein Docker Desktop/WSL2 nötig — ein einziger Installer richtet alles automatisch als Windows-Dienst ein: siehe Installation mit nativem Installer. Gleiche Funktionen und Reichweite, diese Docker-Variante bleibt als Alternative für technisch versierte Nutzer verfügbar.

Vier Stationen bringen dich vom leeren PC bis zur fertig lizenzierten App:

1. Grundinstallation — Docker Desktop und Git installieren, App-Dateien laden, Container bauen lassen und den Einrichtungs-Assistenten durchlaufen (Teil A–G). Danach läuft die App auf diesem PC, im Browser über localhost erreichbar.
2. Für andere Geräte erreichbar (optional) — Nur nötig, um auch von Handy/Tablet im selben WLAN zuzugreifen, plus automatischer Start beim Hochfahren (Teil H–I). Echter Zugriff von unterwegs (außerhalb des WLANs) ist für die Windows-Installation nicht vorgesehen — dafür eignet sich eher eine NAS oder ein Raspberry Pi.
3. Anmeldung an der Zentrale (automatisch) — Passiert von selbst direkt nach dem Einrichtungs-Assistenten — keine Eingabe nötig. Feedback, KI-Felderkennung und E-Mail-Versand sind danach sofort aktiv.
4. Lizenzierung (später, unter „Mein Konto”) — 30 Kalendertage kostenlos und uneingeschränkt nutzbar. Danach direkt in der App einen Lizenzschlüssel bei der Zentrale anfordern — kein Nachfragen bei einer Person nötig.

Das brauchst du

• Einen PC oder Laptop mit Windows 11 (jede Edition, auch „Home” reicht aus) — 64-Bit-Prozessor mit aktivierter Virtualisierung (bei den meisten PCs ab Werk bereits an)
• Admin-Rechte auf diesem PC (für die einmalige Einrichtung), mindestens 6 GB freien Speicherplatz und 8 GB RAM (4 GB reichen technisch, 8 GB empfohlen)
• Internetzugang für die einmalige Einrichtung
• Falls vorhanden: die Adresse einer Zentrale-Installation, mit der diese App verbunden werden soll (der Zugangs-Token dazu wird erst nach dem ersten Start direkt in der App angefragt, siehe Teil G)

Teil A: Virtualisierung (WSL2) aktivieren

1. PowerShell als Administrator öffnen

   Startmenü öffnen, „PowerShell” eingeben, mit Rechtsklick → Als Administrator ausführen starten. Windows fragt danach, ob Änderungen zugelassen werden sollen — mit Ja bestätigen.

2. WSL2 mit einem Befehl einrichten

   Den Befehl unten eintippen und mit Eingabe bestätigen. Dieser eine Befehl aktiviert alle nötigen Windows-Funktionen und installiert die Linux-Umgebung, die Docker Desktop im Hintergrund braucht — Docker selbst wird dabei noch nicht installiert, das folgt in Teil B.

   War WSL2 bereits aktiv (z. B. weil schon einmal genutzt), meldet der Befehl das einfach zurück — kein Fehler, einfach weiter mit Schritt 3.

   wsl --install
   # Wird heruntergeladen: Windows-Subsystem für Linux
   # Wird heruntergeladen: Ubuntu
   # … ein bis zwei Minuten Textausgabe …
   # Der Vorgang wurde erfolgreich abgeschlossen.

   Ist Virtualisierung überhaupt aktiv?

   Task-Manager öffnen (Strg+Umschalt+Esc) → Reiter Leistung → CPU: unten muss „Virtualisierung: Aktiviert” stehen. Falls nicht, im BIOS/UEFI des PCs nachsehen (Bezeichnung je Hersteller unterschiedlich, oft „Intel VT-x”/„AMD-V”) — bei den meisten aktuellen PCs ist das bereits ab Werk eingeschaltet.

3. PC neu starten

   Nach Abschluss des Befehls den PC einmal neu starten, damit die Änderung wirksam wird.

Teil B: Docker Desktop installieren

1. Herunterladen und installieren

   docker.com/products/docker-desktop öffnen, Download for Windows anklicken, die heruntergeladene Datei ausführen. Der Haken bei „Use WSL 2 instead of Hyper-V” ist bereits Standard — nichts umstellen, einfach durchklicken.

2. Docker Desktop starten

   Nach der Installation (ggf. erneuter Neustart) Docker Desktop über das Startmenü öffnen. Nutzungsbedingungen akzeptieren — ein Docker-Konto ist für die reine Nutzung auf diesem PC nicht nötig, ein Anmelde-Hinweis kann übersprungen werden. Docker Desktop läuft danach im Hintergrund (Symbol unten rechts in der Taskleiste).

   Der erste Start dauert manchmal etwas länger, während Docker Desktop die WSL2-Umgebung fertig einrichtet — das Symbol in der Taskleiste zeigt an, sobald „Docker Desktop is running” erreicht ist.

   Fertig eingerichtet, sobald…

   … das Wal-Symbol in der Taskleiste ruhig steht (nicht mehr animiert) und ein Klick darauf „Docker Desktop is running” zeigt.

Teil C: Git installieren

1. Git für Windows herunterladen

   git-scm.com/download/win öffnen — der Download startet automatisch. Installer ausführen und mit den Standardeinstellungen einfach mehrfach „Next” klicken, am Ende „Install”, danach „Finish”. Git wird gebraucht, um die App-Dateien von GitHub herunterzuladen.

Teil D: App-Dateien laden

1. PowerShell öffnen (diesmal ohne Administrator)

   Startmenü → „PowerShell” eingeben → mit einfachem Klick (nicht „Als Administrator”) öffnen.

2. App-Dateien herunterladen

   Legt den Ordner autologbuch im Nutzer-Verzeichnis automatisch mit allen App-Dateien an. Danach mit dem zweiten Befehl in den neuen Ordner wechseln — ab jetzt bleiben alle weiteren Befehle in diesem Ordner, das PowerShell-Fenster kann dafür einfach offen bleiben.

   Nicht aus diesem Kasten kopieren!

   Der Kasten unten zeigt nur eine Vorschau mit dem Platzhalter <TOKEN> — er lässt sich deshalb absichtlich nicht per Klick kopieren. Den fertigen, kompletten Befehl (beide Zeilen bereits fertig zusammengesetzt, inklusive echtem Zugriffstoken) gibt es nach kurzer CAPTCHA-Bestätigung auf autologbuch.de/token.php — dort den ganzen Kasten anklicken (markiert alles), kopieren und 1:1 unverändert in PowerShell einfügen.

   git clone https://<TOKEN>@github.com/Michael7779/AutoLogbuch.git autologbuch
   cd autologbuch

Teil E: App-Konfiguration erzeugen (.env-Datei)

1. Skript ausführen

   Im PowerShell-Fenster (weiterhin im Ordner autologbuch) den Befehl unten eintippen — ganz ohne Eingabe.

   Erzeugt automatisch eine vollständige .env — inklusive zufälligem Datenbank-Passwort. Die Verbindung zur Zentrale wird NICHT hier festgelegt, sondern erst nach dem ersten Start direkt in der App (siehe Teil G).

   .\scripts\init-satellite-env.ps1

Teil F: App bauen und starten

1. Ersten Bauvorgang anstoßen

   Im PowerShell-Fenster (weiterhin im Ordner autologbuch) den Befehl unten eintippen. Baut Datenbank, Backend und Oberfläche und startet alles automatisch. Dauert beim allerersten Mal 10–20 Minuten — das Fenster bleibt währenddessen mit Textausgaben beschäftigt, bis am Ende wieder die normale Eingabezeile erscheint.

2. Status prüfen

   Mit dem zweiten Befehl den Status aller drei Bausteine prüfen — bei allen drei sollte running bzw. healthy stehen.

   docker compose up -d --build
   # … mehrere Minuten Textausgabe …
   
   docker compose ps
   # postgres    running (healthy)
   # backend     running
   # frontend    running

   Was passiert hier?

   Docker Desktop lädt und baut im Hintergrund die drei Bausteine der App und startet sie — sichtbar auch als grafische Übersicht direkt in Docker Desktop selbst (Reiter „Containers”).

Teil G: App öffnen und einrichten

1. Adresse im Browser öffnen

   Beliebigen Browser öffnen, http://localhost:8085 aufrufen. Der Einrichtungs-Assistent legt beim allerersten Aufruf den ersten Benutzer an.

2. Verbindung zur Zentrale herstellen

   Direkt danach zeigt die App automatisch die Seite „Verbindung zur Zentrale herstellen”. Eine Bezeichnung eingeben und Anfrage senden — die Adresse der Zentrale ist fest hinterlegt, keine Eingabe nötig. Der Admin der Zentrale bekommt automatisch eine E-Mail und legt eine Installation samt Zugangs-Token für diesen PC an. Sobald er die Anfrage annimmt, holt sich dieser PC den Token automatisch ab und trägt ihn selbst ein — fertig, ganz ohne weiteres Zutun! Eine Bestätigungsmail zeigt an, dass die Verbindung erfolgreich hergestellt wurde. Klappt das automatische Abholen ausnahmsweise nicht, bleibt die manuelle Eingabe auf derselben Seite jederzeit als Alternative möglich.

3. Updates einrichten

   Für Fehlerbehebungen und neue Funktionen im Ordner autologbuch per PowerShell: git pull; docker compose up -d --build — am besten diesen Befehl merken oder als Verknüpfung ablegen, dann lässt er sich jederzeit bei Bedarf erneut ausführen. Deine Daten (Fahrzeuge, Einträge) bleiben davon unberührt.

Grundinstallation abgeschlossen

Die App ist jetzt auf diesem PC nutzbar. Für Zugriff von anderen Geräten im WLAN weiter mit Teil H, für automatischen Start beim Hochfahren mit Teil I.

Testphase

Ohne Lizenzschlüssel ist die App ab jetzt 30 Tage lang voll nutzbar. Danach kann nur noch gelesen werden, bis der erste angelegte Benutzer unter Mein Konto einen Lizenzschlüssel einträgt — dort auch direkt bei der Zentrale anforderbar, kein Nachfragen bei einer Person nötig.

Teil H: Optional: von anderen Geräten im WLAN erreichbar machen

Standardmäßig ist die App nur auf diesem PC erreichbar — für Handy/Tablet/anderen PC im selben WLAN sind zwei weitere Schritte nötig.

1. IP-Adresse dieses PCs ermitteln

   Im PowerShell-Fenster den Befehl unten eintippen, die Zeile „IPv4-Adresse” unter dem aktiven Netzwerkadapter (WLAN oder LAN) notieren.

   ipconfig
   # IPv4-Adresse. . . . . . . . . . : 192.168.1.60

2. Öffentliche URL auf der Zentrale hinterlegen

   Die App-Adresse wird für einen Satelliten NICHT lokal in der .env eingetragen, sondern kommt automatisch von der Zentrale: dort als Admin unter Einstellungen → Installationen bei diesem PC die „Öffentliche URL” auf http://PC-IP:8085 setzen/ändern (eigene IP aus Schritt 1 einsetzen) — dieser PC übernimmt die neue Adresse von selbst, ganz ohne eigenen Neustart.

3. Windows-Firewall freigeben

   Windows blockiert eingehende Verbindungen von anderen Geräten standardmäßig. Befehl unten in der administrativen PowerShell (wie Teil A, Schritt 1) einmalig ausführen — gibt Port 8085 gezielt für andere Geräte im selben Netzwerk frei.

   New-NetFirewallRule -DisplayName "AutoLogbuch" -Direction Inbound -LocalPort 8085 -Protocol TCP -Action Allow

Tipp

Danach von jedem Gerät im selben WLAN: http://192.168.1.60:8085 öffnen (eigene IP-Adresse einsetzen).

Teil I: Optional: automatischer Start beim Hochfahren

1. Docker Desktop automatisch starten lassen

   Docker Desktop öffnen → Einstellungen (Zahnrad oben rechts) → General → Haken bei „Start Docker Desktop when you sign in” setzen.

   Alle drei Bausteine der App sind bereits so eingerichtet, dass sie sich selbst neu starten (restart: unless-stopped) — sobald Docker Desktop hochfährt, startet die App also automatisch mit, ganz ohne zusätzliches Skript oder erneutes Eintippen von Befehlen.

Häufige Fragen

Docker Desktop meldet einen WSL-Fehler beim Start.

Administrative PowerShell öffnen, wsl --update ausführen, danach den PC neu starten und Docker Desktop erneut öffnen.

Ein Baustein steht nicht auf „running”/„healthy”.

Mit docker compose logs backend (bzw. postgres/frontend) die Fehlermeldung ansehen — meist ein falsch eingetragener Wert in der .env (Teil E), danach docker compose up -d --build erneut ausführen.

Das Skript in Teil E meldet einen Fehler.

Läuft bereits eine .env im Ordner autologbuch (z. B. von einem vorherigen Versuch)? Das Skript überschreibt sie absichtlich NICHT — vorher löschen und erneut ausführen.

Die Passwort-vergessen-E-Mail kommt nicht an.

Prüfen, ob auf der Zentrale eine „Öffentliche URL” für diese Installation hinterlegt ist — sonst werden E-Mails mit Link abgelehnt.

Teil D lädt nichts herunter (Fehler „128”)?

Der über token.php angezeigte Zugriffstoken wurde widerrufen/ist abgelaufen — bei der Person nachfragen, die dir diese Anleitung empfohlen hat, sie kann den Token zentral aktualisieren (kein neuer Anleitungs-Download nötig). Sonst: Ordner autologbuch existiert bereits (z. B. vorheriger Versuch) — git clone bricht dann ab, ohne zu löschen; alten Ordner umbenennen/löschen und erneut ausführen.

Bauen schlägt mit „address already in use” fehl?

Port 8085 bzw. 5433 ist auf diesem PC bereits belegt. In der .env (notepad .env) die Zeilen APP_PORT=8086 bzw. POSTGRES_HOST_PORT=5434 ergänzen (andere freie Portnummer wählen), danach docker compose up -d --build erneut ausführen.

Nach 30 Tagen nur noch Lesezugriff?

Testphase abgelaufen — unter Mein Konto direkt eine Lizenz bei der Zentrale anfordern, kein Nachfragen bei einer Person nötig.

PC bleibt für die App durchgehend an?

Nur bei Teil H nötig: Einstellungen → System → Energie → „Ruhezustand”: Nie.

Fragen, Probleme oder Fehler?

Einfach eine E-Mail an info@autologbuch.de schreiben — möglichst genau beschreiben, an welcher Stelle dieser Anleitung es hakt (z. B. „Teil D, Schritt 1”), und wenn möglich einen Screenshot der betroffenen Stelle beifügen. Das hilft, den Fehler schnell nachzuvollziehen.