Files
tmserver-docker/docs/schnellstart.md
T

2.1 KiB

Schnellstart

Voraussetzungen

  • Docker und Docker Compose müssen installiert sein

1. Umgebungsvariablen einrichten

Kopiere die Vorlage und passe die Werte an:

cp .env.example .env

Bearbeite die .env-Datei und setze mindestens die gewünschten Passwörter. Für den Internet-Modus müssen zusätzlich SERVER_LOGIN und SERVER_VALIDATION_KEY gesetzt werden.

Wichtig: Die .env-Datei enthält sensible Daten (Passwörter, Keys) und wird über die .gitignore vom Einchecken ausgeschlossen.

2. Docker Image bauen

docker build -t tmserver:latest -t tmserver:1.0.0 .

Damit wird das Image mit zwei Tags erstellt: tmserver:latest und tmserver:1.0.0.

3. Server starten

Mit Docker Compose (empfohlen)

docker compose up -d --build

Die Konfiguration erfolgt über die .env-Datei, die automatisch eingelesen wird.

Internet-Modus (docker run)

Für den Internet-Modus wird ein Server-Account benötigt. Dieser kann auf der Trackmania Players-Seite erstellt werden.

docker run -d \
  --env-file .env \
  -p 2350:2350/tcp \
  -p 2350:2350/udp \
  -p 3450:3450/tcp \
  -p 80:80/tcp \
  -v ./data/GameData:/opt/tmserver/GameData \
  --name tmserver tmserver:latest

LAN-Modus (docker run)

Setze in der .env-Datei SERVER_MODE=lan oder übergib es direkt:

docker run -d \
  --env-file .env \
  -e SERVER_MODE=lan \
  -p 2350:2350/tcp \
  -p 2350:2350/udp \
  -p 3450:3450/tcp \
  -p 80:80/tcp \
  -v ./data/GameData:/opt/tmserver/GameData \
  --name tmserver tmserver:latest

4. AdminServ öffnen

Die Verwaltungsoberfläche ist unter http://<host-ip> erreichbar. Weitere Details unter AdminServ.

Persistente Konfiguration

Die gesamten Server-Daten (GameData/) werden über einen Bind-Mount (./data/GameData) persistent auf dem Host gespeichert. Beim ersten Start wird das gesamte GameData-Verzeichnis automatisch aus dem Image erzeugt und die Umgebungsvariablen aus der .env-Datei angewendet. Bei weiteren Starts bleibt alles erhalten.

Weitere Details unter Konfiguration.