Zum Inhalt

Windows-Launcher

Der Windows-Launcher ist eine kleine bibliogon-launcher.exe, die Bibliogon per Doppelklick startet: kein Terminal, keine docker compose-Kommandos. Docker Desktop lässt die App weiterhin laufen, der Launcher startet und stoppt sie nur für dich.

Was der Launcher für dich erledigt. Beim ersten Start erkennt der Launcher, ob Bibliogon bereits auf der Festplatte liegt. Wenn nicht, bietet er an, Bibliogon für dich herunterzuladen und einzurichten (siehe "Erster Start" unten). Du musst nur Docker Desktop selbst installieren; Docker-Lizenzbedingungen verbieten eine stille Drittanbieter-Installation. Plattformübergreifender Überblick: Installations-Übersicht.

Für macOS oder Linux siehe macOS-Launcher / Linux-Launcher.

Einmalige Einrichtung

1. Docker Desktop installieren

Eine vollständige Windows-Anleitung inklusive Abschnitt „Ist Docker sicher zu installieren?" findest du in der Bibliogon-Anleitung zur Docker-Installation. Nach der Installation Docker Desktop starten und warten, bis das Wal-Symbol in der Taskleiste von gelb-orange auf blau wechselt.

Wenn du diesen Schritt überspringst, erkennt der Launcher das fehlende Docker beim Start und zeigt einen Dialog mit drei Schaltflächen (Docker-Downloadseite öffnen, Bibliogon-Docker-Anleitung öffnen, oder Beenden). Du kannst den Launcher nach der Docker-Installation einfach erneut starten.

2. Launcher herunterladen

Von der Releases-Seite zwei Dateien herunterladen, die am Release hängen:

  • bibliogon-launcher.exe
  • bibliogon-launcher.exe.sha256

Beliebiger Ordner: Desktop oder Downloads sind beide in Ordnung.

3. Download prüfen (optional, aber empfohlen)

Bibliogon signiert den Launcher (noch) nicht (siehe Warum kommt eine Sicherheitswarnung? unten). Um zu bestätigen, dass du genau die veröffentlichte Datei hast, öffne PowerShell in dem Ordner und führe aus:

Get-FileHash -Algorithm SHA256 .\bibliogon-launcher.exe
Get-Content .\bibliogon-launcher.exe.sha256

Der Hash aus Get-FileHash muss mit dem Hex-String in der .sha256-Datei übereinstimmen. Wenn nicht, nicht ausführen und ein GitHub Issue öffnen.

Erster Start

Doppelklick auf bibliogon-launcher.exe.

Die SmartScreen-Warnung

Windows zeigt vermutlich einen blauen Dialog: "Der Computer wurde durch Windows geschützt" mit dem Text "Microsoft Defender SmartScreen hat den Start einer unbekannten App verhindert". Das ist bei unsignierter Software zu erwarten und bedeutet nicht, dass der Launcher schädlich ist.

So kommst du weiter:

  1. Weitere Informationen klicken (ein Link im Dialog).
  2. Der Dialog klappt auf und zeigt App-Name und Herausgeber. Auf den neu erscheinenden Trotzdem ausführen-Button klicken.

Hintergrund unter Warum kommt eine Sicherheitswarnung? weiter unten.

Was danach passiert

Die erste Aufgabe des Launchers ist die Erkennung des aktuellen Zustands.

  1. Docker-Prüfung. Der Launcher bestätigt, dass Docker Desktop installiert ist und läuft. Fehlt Docker Desktop, erscheint ein Dialog mit Installations-URL und der Launcher beendet sich. Ist Docker installiert, aber nicht gestartet, bittet ein Dialog um den Start und einen Klick auf Wiederholen; der Launcher versucht es bis zu drei Mal.
  2. Bibliogon-Prüfung. Der Launcher sucht eine bestehende Bibliogon-Installation über die Manifest-Datei (%APPDATA%\bibliogon\install.json) oder, auf einem frischen Rechner, am Standardort %USERPROFILE%\bibliogon.
  3. Bereits installiert: der Launcher fährt direkt mit Schritt 3 fort.
  4. Nicht installiert: ein Willkommensdialog erscheint: "Bibliogon ist auf diesem Rechner noch nicht installiert". Drei Schaltflächen: Installieren (der Launcher lädt die neueste Release-ZIP herunter, entpackt sie in einen von dir gewählten Ordner, generiert eine frische .env und baut die Docker-Images - der erste Build dauert 3-5 Minuten), Installationsanleitung öffnen (öffnet die Doku im Browser), oder Schließen.
  5. Start. Ein kleines "Bibliogon wird gestartet..."-Fenster erscheint, während Docker die Container hochfährt.
  6. Browser. Wenn Bibliogon bereit ist, öffnet dein Standard-Browser http://localhost:7880 (oder den in .env konfigurierten Port).
  7. Statusfenster. Das kleine Fenster wechselt auf "Bibliogon läuft auf localhost:7880" mit einer Schaltfläche Bibliogon beenden.

Bibliogon beenden

Im Launcher-Fenster auf Bibliogon beenden klicken, oder das Fenster einfach schließen. Der Launcher führt docker compose down aus und beendet sich. Docker Desktop läuft weiter; nur die Bibliogon-Container stoppen.

Zweiter Start

Erneuter Doppelklick auf den Launcher. Wenn Bibliogon bereits läuft (z.B. weil du das Launcher-Fenster minimiert hast), erkennt der Launcher die laufende Instanz und öffnet nur den Browser an der korrekten URL, ohne eine zweite Kopie zu starten.

Fehlerbehebung

"Docker Desktop läuft nicht" Docker Desktop aus dem Startmenue öffnen. Warten, bis das Wal-Symbol in der Taskleiste ruhig steht (nicht animiert). Dann im Launcher-Dialog auf Wiederholen klicken.

"Bibliogon-Installation nicht gefunden" Der Launcher findet docker-compose.prod.yml nicht an der Standard- oder konfigurierten Stelle. Mit OK bestätigen und den Ordner auswählen, in dem du Bibliogon geklont oder entpackt hast. Dieser Ordner enthält typischerweise README.md, Makefile und docker-compose.prod.yml.

"Port 7880 wird bereits verwendet" Ein anderes Programm belegt den Bibliogon-Port. Entweder das andere Programm stoppen oder in deinem Bibliogon-Ordner die Datei .env bearbeiten und BIBLIOGON_PORT auf einen anderen Wert setzen (z.B. 7881), dann den Launcher erneut starten.

"Bibliogon ist nicht rechtzeitig gestartet" Der allererste Start einer frischen Installation muss Docker-Images bauen und kann mehrere Minuten dauern. Auf Wiederholen klicken wartet weitere 60 Sekunden. Wenn es weiterhin fehlschlägt, die letzten Log-Zeilen im Dialog prüfen und in Docker Desktops Container-Ansicht nachsehen.

Aktivitätslog Jeder Start schreibt nach %APPDATA%\bibliogon\install.log (1 MB Rotation, 1 Backup). Der alte Pfad %APPDATA%\Bibliogon\launcher.log wird aus Kompatibilitätsgründen weiter befüllt. Bei Bug-Reports bitte die aktuelle Log-Datei anhängen.

Warum kommt eine Sicherheitswarnung?

Windows zeigt die "unbekannte App"-Warnung für jede ausführbare Datei, die nicht mit einem kostenpflichtigen, von Microsoft anerkannten Code-Signing-Zertifikat signiert ist. Solche Zertifikate kosten einige hundert Euro pro Jahr und erfordern laufende Pflege. Für die aktuelle Nutzerbasis veröffentlichen wir den Launcher unsigniert und liefern eine SHA256-Prüfsumme mit, damit du den Download unabhängig verifizieren kannst.

Wir planen, Code-Signing neu zu bewerten, wenn Bibliogon eine Nutzerbasis hat, die die Kosten und den Aufwand rechtfertigt. Bis dahin ist der "Weitere Informationen" -> "Trotzdem ausführen"-Weg der vorgesehene Ablauf. Der Quellcode des Launchers liegt in launcher/ im Bibliogon-Repository; du darfst ihn gerne inspizieren oder selbst bauen.

Deinstallation

Siehe Deinstallieren für den Launcher-Weg und das uninstall.sh-Skript als Fallback.

Kurz: im Launcher-Fenster auf Uninstall klicken und bestätigen. Der Launcher entfernt das Installationsverzeichnis und sein eigenes Manifest. Docker-Volumes (Buchdaten) bleiben standardmäßig erhalten; sie müssen explizit mit entfernt werden, wenn alles weg soll.

Wenn du nur das Launcher-Binary löschen und Bibliogon behalten willst: bibliogon-launcher.exe löschen, optional auch das Konfigurationsverzeichnis %APPDATA%\bibliogon\.

Verwandte Seiten