Docker Compose¶

Die einfachste Möglichkeit, turnierplan.NET auf einem lokalen Rechner, einer VM oder einem dedizierten Server zu installieren, ist mithilfe von Docker Compose. Die nachfolgende YAML-Definition beinhaltet die notwendigen Container für Datenbank sowie den Anwendungsserver:

services:
  turnierplan.database:
    image: postgres:18
    environment:
      - POSTGRES_PASSWORD=P@ssw0rd
      - POSTGRES_DB=turnierplan
    volumes:
      - turnierplan-database-data:/var/lib/postgresql
    networks:
      - turnierplan
    restart: unless-stopped

  turnierplan.application:
    image: ghcr.io/turnierplan-net/turnierplan:2026.2.0
    depends_on:
      - turnierplan.database
    environment:
      - Turnierplan__ApplicationUrl=http://localhost
      - Database__ConnectionString=Host=turnierplan.database;Database=turnierplan;Username=postgres;Password=P@ssw0rd
    volumes:
      - turnierplan-application-data:/var/turnierplan
    networks:
      - turnierplan
    restart: unless-stopped
    ports:
      - '80:8080'

volumes:
  turnierplan-application-data:
  turnierplan-database-data:

networks:
  turnierplan:

Die URL, welche letztendlich für den Zugriff auf turnierplan.NET verwendet wird, sollte in der Umgebungsvariable Turnierplan__ApplicationUrl spezifiziert werden. Falls bspw. eine Domain example.com verwendet wird, sollte der Wert der Umgebungsvariable https://example.com sein. Falls turnierplan.NET im lokalen Netzwerk gehostet wird, könnte der Wert bspw. http://192.168.0.187 sein. Es muss natürlich das korrekte Protokoll (HTTP vs. HTTPS) verwendet werden.

Die Volume-Mounts sind im nachfolgenden Abschnitt näher beschrieben. Je nach Konfiguration kann das Volume-Mount vom turnierlpan.NET-Container auch überflüssig sein.

Beim ersten Starten der Anwendung werden alle Datenbankmigrationen durchgeführt und es wird ein initialer Administrator-Benutzer angelegt. Die Zugangsdaten werden in den Container-Logs angezeigt. Mit diesen Zugangsdaten kann sich in der Weboberfläche unter localhost:80 (bzw. je nach Konfiguration mit entsprechender Domain) eingeloggt werden.

Volume Mounts¶

Die turnierplan.NET-Anwendung speichert diverse Dateien in folgendem Verzeichnis innerhalb vom Container: /var/turnierplan. Bei einer Standardkonfiguration sollte dieses Verzeichnis in einem Docker Volume oder vergleichbar persistiert werden. Die folgenden Daten werden innerhalb vom o.g. Verzeichnis gespeichert:

• Bild-Uploads: Sofern keine anderweitige Speicherung von Bildern (wie z.B. S3) konfiguriert ist.
• JWT Signatur-Schlüssel: Sofern kein Schlüssel via Umgebungsvariable spezifiziert wird, wird ein zufällig generierter Schlüssel hier gespeichert. Siehe auch Konfiguration der Authentifizierung.

Konfiguration¶

turnierplan.NET bietet zahlreiche Konfigurationsmöglichkeiten zur Anbindung von Externen System sowie zur Individualisierung. Alle Optionen können mit Umgebungsvariablen gesetzt werden und sind in der Konfigurationsanleitung aufgelistet und beschrieben.

Erste Schritte¶

Die Anmeldung als Administrator erfolgt mit den Zugangsdaten, welche beim ersten Programmstart generiert und in den Container-Logs ausgegeben werden. Weitere Schritte sind auf der entsprechenden Seite Erste Schritte der Dokumentation beschrieben.

Aktualisierung¶

Die verwendete Version von turnierplan.NET kann jederzeit auf eine neuere aktualisiert werden. Etwaige Datenbankmigrationen werden beim ersten Start sequenziell angewandt - auch wenn Versionen übersprungen werden. Allerdings sollten vor jeder Aktualisierung immer die Release-Notes gelesen werden! Es kann jederzeit nicht-rückwärtskompatible Änderungen geben.

Zudem wird empfohlen, vor jeder Aktualisierung der turnierplan.NET-Anwendung oder der verwendeten PostgreSQL-Version ein Datenbankupdate zu erstellen. Dies kann z.B. mit dem pg_dump-Tool gemacht werden.

Fehlerbehebung¶

Nachfolgend beschrieben sind Fehler, welche bei einer Neuinstallation auftreten können.

Verbindung per HTTP¶

Beim Zugriff auf einen nicht-lokalen turnierplan.NET-Server via HTTP sollte standardmäßig ein Fehler 401 Unauthorized erscheinen. Dies liegt daran, dass turnierplan.NET für die Authentifizierung nach dem Login Cookies verwendet, welche standardmäßig als secure ausgestellt werden. Dies hat zur Folge, dass Browser den Cookie nur bei lokalen Verbindungen oder über HTTPS mitschicken. Um turnierplan.NET dennoch verwenden zu können, muss die Identity__UseInsecureCookies auf true gesetzt werden. Siehe auch Konfiguration der Authentifizierung.