Desktop-Launcher starten¶

Die meisten Nutzer brauchen den Launcher nicht

Adaptive Learner läuft direkt im Browser, ohne Installation, ohne Docker, ohne Launcher: astrapi69.github.io/adaptive-learner. Der Desktop-Launcher ist nur für dich, wenn du die App selbst hosten oder Backend-Features (Server-Modus, lokale Synchronisation) lokal betreiben möchtest.

Der Desktop-Launcher ist der einfachste Weg, Adaptive Learner mit eigenem Backend auf dem eigenen Rechner zu betreiben. Er ist ein kleines Fenster, das alles Weitere für dich erledigt: Er prüft, ob Docker läuft, lädt und baut beim ersten Start das App-Image (einmalig, 5-10 Minuten sind normal), startet die Container und öffnet die App anschließend im Browser unter http://localhost:8501. Aus demselben Fenster kannst du die App auch wieder stoppen, den Port ändern oder alles deinstallieren.

Der Port ist standardmäßig 8501 und im Launcher-Fenster änderbar; ist er belegt, weicht der Launcher auf einen freien Port aus.

Voraussetzung: Docker - der Launcher prüft es selbst¶

Der Launcher setzt ein laufendes Docker voraus, denn die App selbst läuft als Container-Gruppe. Du musst dafür aber nichts von Hand prüfen: Der Launcher kontrolliert beim Start selbst, ob Docker installiert ist und läuft, findet auch einen Docker, der unter einem anderen Docker-Kontext läuft (etwa Docker Desktop für Linux oder rootless Docker), und zeigt dir eine klare Meldung mit Lösung an, falls etwas fehlt. Falls Docker noch gar nicht installiert ist: Docker Desktop installieren.

Die Meldungen des Launchers und was sie bedeuten:

Meldung	Bedeutung	Lösung
"Docker ist nicht installiert (docker nicht im PATH)."	Der `docker`-Befehl wurde nicht gefunden.	Docker Desktop installieren. Der Launcher zeigt den Installations-Link direkt an.
"Docker ist installiert, aber nicht gestartet." bzw. "Docker läuft nicht. Geprüfter Kontext '...' (...): ..."	Der Docker-Dienst läuft gerade nicht; die Detail-Form nennt den geprüften Kontext, den Socket und Dockers Original-Fehler.	Den Knopf "Docker starten" im Launcher anklicken (Linux) bzw. Docker Desktop öffnen (macOS/Windows), dann "Erneut prüfen".
"Docker ist installiert, aber du hast keine Berechtigung."	Dein Benutzer ist nicht in der `docker`-Gruppe (Linux).	Der Launcher zeigt den passenden Befehl direkt an; danach einmal ab- und wieder anmelden.
"Docker antwortet nicht."	Docker startet vermutlich gerade noch (typisch direkt nach dem Öffnen von Docker Desktop).	Einen Moment warten, dann "Erneut prüfen".
"Docker läuft über Kontext '...' - der aktive Kontext war nicht erreichbar, der Launcher hat sich automatisch verbunden."	Nur eine Information: Docker lief unter einem anderen Kontext, der Launcher hat ihn gefunden und nutzt ihn.	Nichts zu tun.
"Docker Desktop ist installiert, aber nicht im PATH."	Die Docker-Desktop-App ist da, aber ihr Kommandozeilen-Werkzeug (noch) nicht erreichbar.	Docker Desktop über den Launcher-Knopf starten und kurz warten.

Die Kontext-Erkennung mit Detail-Meldungen ist ab der auf docker-app-launcher#26 folgenden Launcher-Version enthalten; ältere Versionen zeigen die kürzeren Meldungen aus derselben Tabelle.

Download¶

Alle drei Launcher liegen bei jedem Release unter github.com/astrapi69/adaptive-learner/releases:

Plattform	Datei	Prüfsumme
Linux	`adaptive-learner-launcher`	`adaptive-learner-launcher.sha256`
macOS	`adaptive-learner-launcher-macos.zip`	`adaptive-learner-launcher-macos.zip.sha256`
Windows	`adaptive-learner-launcher.exe`	`adaptive-learner-launcher.exe.sha256`

Linux¶

Prüfsumme verifizieren (beide Dateien im selben Ordner):
```
sha256sum -c adaptive-learner-launcher.sha256
```
Ausführungsrechte setzen. Der Browser-Download nimmt sie dem Binary immer, dieser Schritt ist also immer nötig:
```
chmod +x adaptive-learner-launcher
```
Starten, am einfachsten im Terminal:
```
./adaptive-learner-launcher
```
Doppelklick im Dateimanager funktioniert je nach Umgebung ebenfalls; in GNOME/Nautilus muss dafür unter Eigenschaften > Zugriffsrechte "Datei als Programm ausführen" gesetzt sein. Der Terminal-Start hat den Vorteil, dass du Fehlermeldungen direkt siehst.

Bekannte Stolpersteine:

"Permission denied": Schritt 2 vergessen (chmod +x).
GLIBC-Fehler beim Start: Das Binary wird auf Ubuntu 22.04 gebaut und braucht glibc 2.35 oder neuer (Ubuntu 22.04+, Debian 12+, Fedora 36+). Auf älteren Distributionen stattdessen die App per install.sh oder Docker Compose direkt betreiben.
App im Browser nicht erreichbar: Die App läuft nur lokal (localhost), eine Firewall-Freigabe ist dafür nicht nötig. Öffnet der Browser nicht automatisch, rufe http://localhost:8501 von Hand auf (bzw. den im Launcher-Fenster angezeigten Port).

macOS¶

Prüfsumme verifizieren und ZIP entpacken:

shasum -a 256 -c adaptive-learner-launcher-macos.zip.sha256
unzip adaptive-learner-launcher-macos.zip

Beim ersten Öffnen blockiert Gatekeeper das Binary als "nicht verifizierter Entwickler". Zwei Wege:
- Rechtsklick (bzw. Ctrl-Klick) auf das Binary > Öffnen > im Dialog erneut Öffnen. Das merkt sich macOS für alle weiteren Starts.
- Oder: Systemeinstellungen > Datenschutz & Sicherheit > unten bei der blockierten App auf Dennoch öffnen.

Windows¶

Prüfsumme verifizieren (PowerShell, beide Dateien im selben Ordner):

Get-FileHash .\adaptive-learner-launcher.exe -Algorithm SHA256
Get-Content .\adaptive-learner-launcher.exe.sha256

Die beiden Hash-Werte müssen übereinstimmen.

adaptive-learner-launcher.exe doppelklicken. Beim ersten Start warnt SmartScreen ("Der Computer wurde durch Windows geschützt"): Weitere Informationen anklicken, dann Trotzdem ausführen.

Wenn etwas hakt¶

Der Launcher zeigt selbst einen Hinweis-Dialog, wenn Docker nicht läuft, und bietet an, Docker Desktop zu starten.
Der erste Start lädt und baut das App-Image; die Schritt-Checkliste im Launcher-Fenster (Check Docker / Download / Build / Start / Ready) zeigt den Fortschritt. Spätere Starts sind schnell.
Läuft die App, erreichst du sie jederzeit unter http://localhost:8501 (oder deinem geänderten Port); der Button "Im Browser öffnen" im Launcher tut dasselbe.