TM-Server Docker

Ein vollständiges Docker-Setup für einen TrackMania Nations Forever-Server – inklusive Web-Verwaltung und Server-Controller

🏰 Website · 📰 Community · 🐘 Mastodon · 💬 Support

✨ Übersicht

• TrackMania Dedicated Server – der eigentliche Spielserver für Internet- oder LAN-Betrieb
• XAseco – Server-Controller, der lokale Rekorde, Dedimania-Weltrekorde, Karma/Votes und eine Track-Jukebox direkt im Spielchat verwaltet
• AdminServ – Web-Oberfläche zur komfortablen Verwaltung und Konfiguration des Servers
• RemoteCP – alternative Web-Verwaltungsoberfläche mit eigenem Login- und Benutzersystem

Alle Komponenten laufen in einem einzigen Container und werden über Umgebungsvariablen konfiguriert.

Hinweis: Dieses Projekt ist ein Fork von lduriez/tmserver-docker.

Der Server unterstützt sowohl den Internet-Dedicated-Modus (Standard) als auch den LAN-Dedicated-Modus.

🚀 Schnellstart

1. Umgebungsvariablen einrichten

cp .env.example .env

Passe die Werte in der .env-Datei an deine Umgebung an (Passwörter, Masterserver-Account, etc.).

⚠ Sicherheitshinweis: Die .env.example enthält vorgenerierte Beispiel-Passwörter. Diese dienen nur als Platzhalter und sind öffentlich einsehbar! Ändere unbedingt alle Passwörter, bevor du den Server produktiv einsetzt.

2. Server starten

Das fertige Docker Image kann direkt verwendet werden – kein eigener Build nötig:

docker compose up -d

Das Image wird automatisch aus der Container-Registry geladen:

git.techniverse.net/scriptos/trackmania-server:latest

Tipp: Alle verfügbaren Tags findest du in der Container-Registry. Wenn du das Image lieber selbst bauen möchtest, findest du die Anleitung unter Schnellstart – Selbst bauen.

3. Verwaltungsoberflächen öffnen

• AdminServ: http://<host-ip>/
• RemoteCP: http://<host-ip>/remotecp/

Hinweis: Für den Internet-Modus müssen SERVER_LOGIN und SERVER_VALIDATION_KEY in der .env-Datei gesetzt sein. Einen Server-Account kannst du auf players.trackmaniaforever.com erstellen. Für den LAN-Modus setze SERVER_MODE=lan.

📚 Dokumentation

Die vollständige Dokumentation befindet sich im Ordner docs/:

• Schnellstart – Erste Schritte und minimale Konfiguration
• Konfiguration – Persistente Serverkonfiguration (dedicated_cfg.txt)
• Umgebungsvariablen – Alle verfügbaren Umgebungsvariablen
• Server-Modi – LAN- und Internet-Dedicated-Modus
• AdminServ – Einrichtung der Server-Verwaltungsoberfläche
• RemoteCP – Alternative Server-Verwaltungsoberfläche
• XAseco – Server-Controller für Rekorde, Karma und Jukebox
• IP-Watcher – Automatischer Neustart bei IP-Wechsel
• Ports – Freigegebene Ports und deren Verwendung
• Update – Bestehende Installation aktualisieren

🙏 Danksagung

Ein herzliches Dankeschön an Thomas – für seine tatkräftige Unterstützung, sein wertvolles Wissen und seine Mitwirkung an diesem Projekt. Ohne ihn wäre dieses Projekt nicht das, was es heute ist!

🔄 Spiegelung

Dieses Repository wird von Gitea auf GitHub gespiegelt. Das Master-Repository befindet sich auf Gitea:

• Gitea (Master): git.techniverse.net/scriptos/tmserver-docker
• GitHub (Spiegel): github.com/pscriptos/tmserver-docker

_{© Patrick Asmus · Techniverse Network · Lizenz}