Zum Inhalt

Linux-Launcher

Der Linux-Launcher ist ein bibliogon-launcher-linux-ELF-Binary, das Bibliogon per Klick startet: keine docker compose-Kommandos, keine offenen Terminal-Sitzungen. Docker führt die Anwendung weiterhin aus, 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 selbst installieren; Docker-Lizenzbedingungen verbieten eine stille Drittanbieter-Installation. Plattformübergreifender Überblick: Installations-Übersicht.

Systemanforderungen

  • Eine aktuelle 64-Bit-Linux-Distribution (Ubuntu 22.04+, Fedora 38+, Debian 12+, Arch oder vergleichbar). Das Binary wird auf ubuntu-22.04 gebaut, daher ist glibc 2.35 oder neuer erforderlich. Ältere Distributionen werden nicht unterstützt.
  • Docker Engine oder Docker Desktop, mit deinem Benutzer in der Gruppe docker.
  • Die Tk-Laufzeitumgebung (python3-tk auf Debian/Ubuntu, tk auf Arch, python3-tkinter auf Fedora), falls das im PyInstaller-Binary mitgelieferte Tk meckert. Die meisten Distributionen haben das bereits; Berichte über fehlendes Tk sind bislang nicht aufgetaucht.

Einmalige Einrichtung

1. Docker installieren

Den vollständigen Überblick inklusive Abschnitt „Ist Docker sicher zu installieren?" findest du in der Bibliogon-Anleitung zur Docker-Installation. Auf Linux sind zwei Wege üblich:

  • Docker Engine (nativ, empfohlen für Server und minimale Desktops): docs.docker.com/engine/install. Nach der Installation den eigenen Benutzer in die Gruppe docker aufnehmen und ab- und wieder anmelden:
sudo usermod -aG docker "$USER"

Prüfen, dass Docker ohne sudo erreichbar ist:

docker info

2. Launcher herunterladen

Von der Releases-Seite zwei an das Release angehängte Dateien laden:

  • bibliogon-launcher-linux
  • bibliogon-launcher-linux.sha256

Speicherort beliebig; ~/Downloads ist in Ordnung.

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

Der Launcher ist nicht signiert. Um zu bestätigen, dass das Binary exakt die veröffentlichte Datei ist, im Terminal im Download-Ordner:

sha256sum bibliogon-launcher-linux
cat bibliogon-launcher-linux.sha256

Der Hash von sha256sum muss mit der Hex-Zeichenkette in der .sha256-Datei übereinstimmen. Wenn nicht, das Binary nicht ausführen und das Ganze auf GitHub Issues melden.

4. Launcher ausführbar machen

chmod +x bibliogon-launcher-linux

Optional in einen Ordner im PATH verschieben (zum Beispiel ~/bin oder ~/.local/bin), um den Launcher aus jedem Verzeichnis heraus starten zu können.

Erster Start

Launcher aus dem Terminal starten:

./bibliogon-launcher-linux

Oder, wenn die Desktop-Umgebung das Starten von Binarys aus dem Dateimanager unterstützt, Rechtsklick auf die Datei und "Ausführen" oder "Öffnen" wählen (GNOME Files: in den Einstellungen "Ausführbare Textdateien: Nachfragen" aktivieren).

Was beim ersten Start passiert

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

  1. Docker-Prüfung. Der Launcher bestätigt, dass Docker installiert und ohne sudo erreichbar ist. Fehlt Docker, erscheint ein Dialog mit Installations-URL und der Launcher beendet sich. Ist Docker installiert, aber nicht gestartet (oder der Benutzer noch nicht in der Gruppe docker), 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 (~/.config/bibliogon/install.json) oder, auf einem frischen Rechner, am Standardort ~/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 Fenster mit "Bibliogon startet..." erscheint, während Docker die Container hochfährt.
  6. Browser. Sobald Bibliogon bereit ist, öffnet sich der Standard-Browser auf http://localhost:7880 (bzw. dem in .env konfigurierten Port).
  7. Statusfenster. Das kleine Fenster wechselt zu "Bibliogon läuft auf localhost:7880" mit der Schaltfläche Bibliogon stoppen.

Bibliogon stoppen

In der Launcher-Leiste auf Bibliogon stoppen klicken oder das Fenster einfach schließen. Der Launcher führt docker compose down aus und beendet sich. Docker läuft im Hintergrund weiter; nur die Bibliogon-Container werden gestoppt.

Zweiter Start

Launcher erneut starten. Wenn Bibliogon bereits läuft (etwa weil das Fenster minimiert war), erkennt der Launcher die laufende Instanz und öffnet einfach den Browser auf der richtigen URL, ohne eine zweite Kopie zu starten.

Fehlerbehebung

"Docker läuft nicht" oder "permission denied" auf docker.sock Prüfen, ob Docker ohne sudo erreichbar ist:

docker info

Falls das mit einem Berechtigungsfehler fehlschlägt, bist du noch nicht in der Gruppe docker. Nach sudo usermod -aG docker "$USER" musst du dich komplett aus der Sitzung abmelden (nicht nur das Terminal schließen) und wieder anmelden. Unter Wayland ist manchmal ein kompletter Neustart nötig, damit der Gruppenwechsel greift.

"Bibliogon-Installation nicht gefunden" Der Launcher findet docker-compose.prod.yml nicht unter dem Default- oder konfigurierten Pfad. OK klicken, dann den Ordner wählen, in dem Bibliogon liegt. Der Ordner enthält typischerweise README.md, Makefile und docker-compose.prod.yml.

"Port 7880 ist belegt" Ein anderes Programm nutzt den Port. Optionen: das andere Programm stoppen oder in der .env des Bibliogon-Ordners BIBLIOGON_PORT auf einen anderen Wert setzen (zum Beispiel 7881) und den Launcher neu starten.

"Bibliogon ist nicht rechtzeitig gestartet" Der erste Start einer frischen Installation baut die Docker-Images, was einige Minuten dauern kann. Wiederholen klicken, um weitere 60 Sekunden zu warten. Falls es weiter scheitert, die letzten Log-Zeilen im Dialog prüfen und ausführen:

docker compose -f ~/bibliogon/docker-compose.prod.yml logs --tail=100

"./bibliogon-launcher-linux: cannot execute: required file not found" Das Binary braucht glibc 2.35 oder neuer. Du bist auf einer älteren Distribution. Die Distribution aktualisieren oder Bibliogon stattdessen über install.sh aus dem Repository installieren.

"error while loading shared libraries: libtk..." Tk ist nicht installiert. Das Tk-Paket deiner Distribution installieren (python3-tk auf Debian/Ubuntu, tk auf Arch, python3-tkinter auf Fedora). Ein AppImage mit gebündeltem Tk ist als D-03a vorgemerkt und hängt davon ab, wie oft dieses Problem auftritt.

Aktivitätslog Jeder Start schreibt nach ~/.config/bibliogon/install.log (1 MB Rotation, 1 Backup). Diese Datei Fehlerberichten beilegen. Siehe Abschnitt Aktivitätslog für Details.

Aktivitätslog

Jede Launcher-Aktion (Installation, Deinstallation, Docker-Operationen, Fehler) wird geschrieben nach:

~/.config/bibliogon/install.log

Das Log rotiert bei 1 MB mit einem Backup (install.log.1). Bei einer Fehlermeldung auf GitHub die aktuelle Log-Datei anhängen oder die letzten 50-100 Zeilen einfügen; der Fehler steht meistens direkt drin.

Deinstallation

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

Kurz: auf Uninstall im Launcher-Fenster 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.

Verwandte Seiten