Der komplette SwissTD Playground auf deinem Rechner: Frontend, Backend mit FastAPI, PostgreSQL und alle sechs Services mit Gateway.
Ohne Browser-Grenzen, mit echter Datenbank. In drei Schritten startklar.
Installation
Docker Desktop ist kostenlos und läuft auf macOS, Windows und Linux. Falls du es noch nicht hast:
Docker Desktop holenBereits installiert? Stelle sicher, dass Docker Desktop läuft (Wal-Symbol in der Taskleiste).
Ein Paket für alle Systeme. Darin liegen beide Startdateien und eine Anleitung.
SwissTD Playground starten.bat
SwissTD Playground starten.command
Bitte akzeptiere zuerst den Haftungsausschluss, um den Download freizuschalten.
Archiv entpacken, dann Doppelklick auf die Datei für dein System —
.bat unter Windows,
.command auf Mac und Linux.
Beim ersten Mal blockiert dein System die Datei. Das ist normal und einmalig — die vollständige Anleitung liegt im Paket.
Windows: Weitere Informationen → Trotzdem ausführen.
Mac: im Dialog auf Fertig, dann Systemeinstellungen → Datenschutz & Sicherheit → ganz unten Dennoch öffnen. Danach die Datei erneut doppelklicken.
Mehr ist nicht zu tun. Was danach passiert, steht unten.
Dann passiert Folgendes:
localhost:8080
Alles landet im Ordner SwissTD-Playground in deinem
Benutzerverzeichnis. Zum Aufräumen genügt es, ihn zu löschen.
Ausführliche Anleitung
Beim ersten Start blockiert jedes System Dateien aus dem Internet. Das ist normal und einmalig. So kommst du daran vorbei:
SwissTD Playground starten.bat
SwissTD Playground starten.command
Warum überhaupt eine Warnung? Die Startdatei ist nicht bei Apple bzw. Microsoft registriert — das kostet eine Jahresgebühr, die wir für ein Lernwerkzeug nicht zahlen. Der Inhalt ist offen: beide Startdateien lassen sich mit jedem Texteditor öffnen und lesen. Dieselbe Anleitung liegt auf Deutsch und Englisch im heruntergeladenen Paket.
Für Fortgeschrittene
Du kannst den Playground auch direkt mit docker compose starten. Lade die Compose-Datei herunter und führe sie im Terminal aus:
$ docker compose -f docker-compose.prod.yml up -d
Oder in einer Zeile, ohne vorher etwas herunterzuladen — auf macOS und Linux:
Bitte akzeptiere zuerst den Haftungsausschluss, um den Download freizuschalten.
Häufige Fragen
Docker ist eine Plattform, die Anwendungen in sogenannten «Containern» verpackt. Stell dir einen Container wie eine portable Box vor, die alles enthält, was eine App braucht: Code, Bibliotheken, Datenbanken. Du installierst nur Docker Desktop, alles andere kommt automatisch.
Kaum. Unter Windows genügt ein Doppelklick. Auf dem Mac und unter Linux öffnest du einmal das Terminal und fügst eine fertige Zeile ein — tippen musst du nichts, sie steht oben zum Kopieren bereit. Alles Weitere erledigt das Skript. Docker Desktop muss lediglich im Hintergrund laufen.
Öffne ein Terminal im selben Ordner und führe aus:
$ docker compose down
Alternativ kannst du die Container in Docker Desktop unter «Containers» stoppen.
Docker Desktop läuft auf den meisten modernen Systemen:
Mindestens 4 GB RAM und 5 GB freier Speicherplatz empfohlen.
Die Browser-Version nutzt PGlite (PostgreSQL als WASM) und läuft komplett im Browser, ideal zum Ausprobieren. Die Docker-Version startet eine echte PostgreSQL-Datenbank, ein FastAPI-Backend und alle Services. Damit funktionieren auch API-Tests (Postman, REST), Performance-Tests (k6) und Datenbankabfragen über SQL.