FiveM-Server auf CasaOS ausführen: Docker-Einrichtungsanleitung

Ja, ein FiveM-Server kann über Docker auf einem CasaOS-Host ausgeführt werden. Zu diesem Ergebnis kam der IceWhale-Community-Thread vom September 2023: Der alte Gaming-PC des Nutzers verfügte bereits über genügend Ressourcen für CasaOS-Workloads, und Community-Mitglieder wiesen darauf hin, dass der FXServer von FiveM Linux-Builds besitzt und als benutzerdefinierte CasaOS-Anwendung in einem Container ausgeführt werden kann.

Der historische Thread verwendete den Drittanbieter spritsail/fivem Das Image und sowohl den FiveM-Spielport als auch txAdmin freigegeben. Das bleibt ein nützlicher Ausgangspunkt für die Architektur, sollte jedoch nicht mit einem offiziellen Cfx.re-CasaOS-Paket verwechselt werden. Die aktuelle Cfx.re-Dokumentation unterstützt weiterhin FXServer unter Linux, weist jedoch ausdrücklich darauf hin, dass es sich beim Linux-Server um eine Bereitstellung aus Kulanz handelt und Windows im Allgemeinen eine bessere Kompatibilität sowie besseren Diagnosesupport bietet. Auch 2026 traten weiterhin Linux-/Docker-spezifische FiveM-Probleme auf. Teste daher genau das Server-Artefakt und den Spiel-Build, die du verwenden möchtest.

Was der ursprüngliche CasaOS-Thread bestätigte

Im ursprünglichen CasaOS-Thread wurde gefragt, ob ein privater FiveM-Server auf einem alten Gaming-PC betrieben werden könne, der bereits als CasaOS-Server diente. Zwei Antworten lieferten die hilfreiche Auskunft:

FiveM/FXServer kann unter Linux und in Docker ausgeführt werden.
Eine benutzerdefinierte CasaOS-Anwendung kann die erforderlichen Ports freigeben und Konfiguration sowie Daten dauerhaft speichern.
Der Server benötigt weiterhin einen gültigen Cfx.re-Lizenzschlüssel.
Die Hardware muss für die Anzahl der Spieler, Ressourcen, Skripte und die Datenbankauslastung ausreichend leistungsfähig sein.

Der Ausgangspunkt für Docker Compose aus der Community

Die Antwort von 2023 schlug eine benutzerdefinierte CasaOS-App-Definition auf Grundlage des Drittanbieter-Images vor. spritsail/fivem image:

services:
  fivem:
    image: spritsail/fivem
    restart: on-failure
    environment:
      LICENSE_KEY: YOUR_LICENSE_KEY
      NO_DEFAULT_CONFIG: 1
    ports:
      - "40120:40120"
      - "30120:30120"
      - "30120:30120/udp"
    volumes:
      - /DATA/AppData/fivem/config:/config
      - /DATA/AppData/fivem/data:/txData
    stdin_open: true
    tty: true

Dies ist eine aus der Quelle abgeleitete historische Konfiguration und keine von IceWhale gepflegte App-Definition. Prüfe die aktuelle Image-Dokumentation, bevor du sie in ein aktives CasaOS-System importierst.

Welche Ports benötigt FiveM?

Die Community-Konfiguration enthielt:

30120/TCP — Hauptverkehr für das FXServer-Spiel.
30120/UDP — Hauptverkehr von FXServer über UDP.
40120/TCP — txAdmin-Weboberfläche in der Quellkonfiguration.

In der aktuellen Cfx.re-txAdmin-Dokumentation wird weiterhin Port 40120 als Standard-HTTP-Port von txAdmin aufgeführt. Siehe die aktuelle txAdmin-Dokumentation.

Cfx.re-Lizenzschlüssel erstellen

Die aktuelle Dokumentation zur Cfx.re-Servereinrichtung erfordert vor dem Start von FXServer einen Serverlizenzschlüssel. Registrieren Sie den Server über den aktuellen Cfx.re-/Cfx-Portal-Workflow und bewahren Sie den Schlüssel vertraulich auf.

Offizielle Referenz: Einen Server einrichten.

Übertragen Sie den Schlüssel nicht in ein öffentliches Git-Repository und fügen Sie ihn nicht in Screenshots ein. Umgebungsvariablen in CasaOS sind praktisch, aber jeder mit administrativem Zugriff auf die Docker-Konfiguration kann den Schlüssel möglicherweise auslesen.

Konfiguration und txAdmin-Daten dauerhaft speichern

Das ursprüngliche Compose mountete:

/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data   → /txData

Das Prinzip ist wichtiger als die genauen Pfade: Die Serverkonfiguration und txAdmin-Profile sollten auf dauerhaftem Host-Speicher liegen, damit die Neuerstellung des Containers den Serverstatus nicht löscht.

Sichern Sie diese Verzeichnisse, bevor Sie Container-Images oder Serverartefakte ändern.

Die aktuelle FiveM-Dokumentation behandelt Linux weiterhin als sekundäre Serverportierung

Die aktuelle Dokumentation zur Vanilla-Einrichtung von Cfx.re enthält einen wichtigen Linux-Hinweis: Die Linux-Version von FXServer wird als Portierung ohne Gewähr bereitgestellt, da die Kompatibilität mit Linux-Distributionen und native Diagnosewerkzeuge schwieriger sein können. Dort steht, dass Probleme unter Windows mit höherer Wahrscheinlichkeit behoben werden.

Das bedeutet nicht, dass Linux-Server unbrauchbar sind. Es bedeutet, dass eine CasaOS-Docker-Bereitstellung im Vergleich zu einem regulären, unterstützten Windows-Server eine zusätzliche Kompatibilitätsebene aufweist.

Spezifische FiveM-Docker-Probleme bestehen auch 2026 weiterhin

Aktuelle CitizenFX-Problemberichte zeigen, dass ein Linux-FXServer zwar korrekt in Docker laufen kann, bestimmte erzwungene Game-Builds oder Enhanced-Artefakte jedoch weiterhin containerspezifische Fehler auslösen. Beispielsweise wurde in einem Problembericht aus dem Jahr 2026 ein Clientabsturz reproduziert mit sv_enforceGameBuild 3751 unter Linux/Docker, während derselbe Vanilla-Container ohne diese Einstellung problemlos funktionierte.

Deshalb garantieren ein erfolgreich gestarteter Container und eine erreichbare txAdmin-Seite nicht, dass jede Kombination aus FiveM-Artefakt und Ressource stabil läuft.

Wie viel Hardware benötigen Sie?

Die ursprüngliche Antwort von 2023 zitierte veraltete Mindestanforderungen an Desktop-Systeme für FiveM. Diese Werte sind keine zuverlässige moderne Formel zur Serverdimensionierung. Der Bedarf an dedizierten Serverressourcen hängt stark ab von:

Spieleranzahl;
Anzahl der Frameworks und Ressourcen;
Qualität der Lua-/JavaScript-/C#-Skripte;
Datenbank-Workload;
OneSync-Konfiguration;
zusätzliche Dienste wie MariaDB/MySQL.

Für einen kleinen privaten Server kann ein älterer Gaming-PC ausreichen, aber die Single-Thread-Leistung der CPU und der verfügbare RAM-Spielraum sind wichtiger, als einfach eine historische Mindestanforderungsliste zu erfüllen.

FiveM-Frameworks benötigen möglicherweise eine separate Datenbank

Wenn du ESX, QBCore oder ein anderes Framework installierst, muss der FiveM-Container möglicherweise einen MariaDB-/MySQL-Container erreichen. Platziere beide Dienste in einem benutzerdefinierten Docker-Netzwerk, damit sie über einen stabilen Dienstnamen statt über wechselnde Container-IP-Adressen kommunizieren können.

Speichere die Datenbankdaten in einem eigenen persistenten CasaOS-AppData-Verzeichnis und sichere sie unabhängig von den FXServer-Dateien.

Teste im LAN, bevor du den Server für das Internet öffnest

Beginne mit einem lokalen Test:

Vergewissere dich, dass der FiveM-Container weiterhin ausgeführt wird.
Öffne txAdmin unter http://CASAOS_IP:40120 wenn das Image den Standardport verwendet.
Schließe die txAdmin-Konfiguration ab.
Bestätige 30120/TCP und 30120/UDP sind zugeordnet.
Verbinde dich von einem anderen Gerät im LAN.
Konfiguriere Router-/Firewall-Regeln erst nach dem lokalen Test, wenn Spieler aus dem Internet Zugriff benötigen.

Internet-Hosting bringt zusätzliche Sicherheitsverantwortung mit sich

Ein öffentlich zugänglicher Spielserver empfängt unerwünschten Internetverkehr. Halte CasaOS selbst, SSH, die Docker-API und Datenbank-Ports privat. Mache nur die von FXServer/txAdmin benötigten Ports öffentlich zugänglich und erwäge, den Zugriff auf txAdmin einzuschränken, anstatt die Verwaltungsoberfläche allgemein offen zu lassen.

Mache MariaDB/MySQL nicht einfach deshalb direkt im Internet zugänglich, weil FiveM eine Datenbank benötigt.

Checkliste für einen FiveM-Server unter CasaOS

Vergewissere dich, dass der Host über ausreichend CPU, RAM und Speicherplatz verfügt.
Erstelle einen Cfx.re-Server-Lizenzschlüssel.
Wähle ein gepflegtes FiveM-/FXServer-Docker-Image oder erstelle das Image selbst aus aktuellen Artefakten.
Speichere Konfiguration und txData außerhalb des Containers.
Öffne 30120/TCP und 30120/UDP.
Mache txAdmin nur bei Bedarf öffentlich zugänglich.
Teste zunächst lokal, bevor du öffentliche Firewall-/NAT-Regeln konfigurierst.
Sichere txData, Ressourcen, server.cfg und jede externe Datenbank.
Rechne mit Kompatibilitätsunterschieden zwischen Linux/Docker und dem Windows-FXServer.

FAQ zu FiveM unter CasaOS

Kann FiveM unter CasaOS ausgeführt werden?

Ja. Der Quellthread enthielt eine funktionierende Docker-Architektur für eine benutzerdefinierte CasaOS-App. Das Container-Image selbst stammte von einem Drittanbieter und war kein offizielles CasaOS-Paket.

Ist spritsail/fivem ein offizielles Cfx.re-Image?

Nein. Es handelt sich um ein Docker-Image eines Drittanbieters, auf das die Community verweist. Prüfe vor der Verwendung den aktuellen Wartungszustand.

Welche Ports sollte ich zuordnen?

Die verwendete Quellkonfiguration 30120/TCP, 30120/UDPund 40120/TCP für txAdmin.

Wird Linux/Docker genauso gut unterstützt wie Windows?

Nicht ganz. Die aktuelle Cfx.re-Dokumentation beschreibt den Linux-FXServer ausdrücklich als eine Portierung aus Kulanz und weist darauf hin, dass Windows bei der Behebung von Kompatibilitätsproblemen voraussichtlich bevorzugt wird.