Oui, un serveur FiveM peut fonctionner sur un hôte CasaOS via Docker. C’est la conclusion à laquelle est parvenu le fil de discussion de la communauté IceWhale en septembre 2023 : l’ancien PC de jeu de l’utilisateur disposait déjà de ressources suffisantes pour les charges de travail CasaOS, et les membres de la communauté ont indiqué que FXServer de FiveM proposait des versions Linux et pouvait être conteneurisé en tant qu’application CasaOS personnalisée.
Le fil historique utilisait l’image tierce spritsail/fivem l’image et exposait à la fois le port de jeu FiveM et txAdmin. Cela reste une architecture de départ utile, mais il ne faut pas la confondre avec un paquet CasaOS officiel de Cfx.re. La documentation actuelle de Cfx.re prend toujours en charge FXServer sous Linux, tout en précisant que le serveur Linux est un port proposé à titre gracieux et que Windows bénéficie généralement d’une meilleure compatibilité et d’un meilleur support de diagnostic. En 2026, des problèmes spécifiques à FiveM sous Linux/Docker ont également continué à apparaître ; testez donc l’artefact serveur exact et la version du jeu que vous prévoyez d’utiliser.
Ce que le fil de discussion CasaOS d’origine a confirmé
Le message source demandait s’il était possible d’exécuter un serveur FiveM privé sur un ancien PC de jeu servant déjà de serveur CasaOS. Deux réponses ont fourni l’information utile suivante :
- FiveM/FXServer peut fonctionner sous Linux et dans Docker.
- Une application CasaOS personnalisée peut exposer les ports requis et conserver la configuration et les données.
- Le serveur a toujours besoin d’une clé de licence Cfx.re valide.
- Le matériel doit être suffisamment puissant en fonction du nombre de joueurs, des ressources, des scripts et de la charge de travail de la base de données.
Le point de départ avec Docker Compose de la communauté
La réponse de 2023 proposait une définition d’application personnalisée CasaOS basée sur l’image tierce 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: trueIl s’agit d’une configuration historique dérivée de la source, et non d’une définition d’application maintenue par IceWhale. Consultez la documentation actuelle de l’image avant de l’importer dans un système CasaOS en production.
De quels ports FiveM a-t-il besoin ?
La configuration de la communauté exposait les éléments suivants :
-
30120/TCP— trafic de jeu principal de FXServer. -
30120/UDP— trafic UDP principal de FXServer. -
40120/TCP— interface web txAdmin dans la configuration source.
La documentation actuelle de txAdmin par Cfx.re indique toujours le port 40120 comme port HTTP txAdmin par défaut. Consultez la documentation de txAdmin.
Créer une clé de licence Cfx.re
La documentation actuelle de configuration des serveurs Cfx.re exige une clé de licence serveur avant le démarrage de FXServer. Enregistrez le serveur via le processus actuel de Cfx.re/Cfx Portal et gardez la clé privée.
Référence officielle : Configurer un serveur.
Ne commitez pas la clé dans un dépôt Git public et ne la collez pas dans des captures d’écran. Les variables d’environnement CasaOS sont pratiques, mais toute personne disposant d’un accès administrateur à la configuration Docker peut être en mesure de les lire.
Conserver la configuration et les données txAdmin
Le fichier Compose original montait :
/DATA/AppData/fivem/config → /config
/DATA/AppData/fivem/data → /txDataLe principe est plus important que ces chemins exacts : la configuration du serveur et les profils txAdmin doivent être stockés sur un espace persistant de l’hôte afin que la recréation du conteneur n’efface pas l’état du serveur.
Avant de modifier les images de conteneurs ou les artefacts du serveur, sauvegardez ces répertoires.
La documentation FiveM actuelle traite toujours Linux comme un port serveur secondaire
La documentation actuelle de Cfx.re sur l’installation vanilla contient un avertissement important concernant Linux : la version Linux de FXServer est fournie à titre gracieux, car la compatibilité entre les distributions Linux et les outils de diagnostic natifs peut être plus difficile à assurer. Elle précise que les problèmes ont plus de chances d’être corrigés sous Windows.
Cela ne signifie pas que les serveurs Linux sont inutilisables. Cela signifie qu’un déploiement Docker CasaOS comporte une couche de compatibilité supplémentaire par rapport à un serveur Windows normal pris en charge.
Les problèmes FiveM spécifiques à Docker existent toujours en 2026
Des rapports récents concernant des problèmes de CitizenFX montrent qu’un FXServer Linux peut fonctionner correctement dans Docker, tandis que certains builds de jeu imposés ou artefacts Enhanced peuvent tout de même provoquer des erreurs propres aux conteneurs. Par exemple, un problème signalé en 2026 a permis de reproduire un plantage du client avec sv_enforceGameBuild 3751 sous Linux/Docker, alors que le même conteneur vanilla fonctionnait sans ce paramètre.
C’est pourquoi le démarrage réussi d’un conteneur et l’accès à la page txAdmin ne garantissent pas que chaque combinaison d’artefacts et de ressources FiveM sera stable.
De quel matériel avez-vous besoin ?
La réponse originale de 2023 citait d’anciennes exigences minimales pour un ordinateur de bureau FiveM. Ces valeurs ne constituent pas une formule fiable pour dimensionner un serveur moderne. Les besoins d’un serveur dédié dépendent fortement des éléments suivants :
- nombre de joueurs ;
- nombre de frameworks et de ressources ;
- qualité des scripts Lua/JavaScript/C# ;
- charge de travail de la base de données ;
- configuration de OneSync ;
- des services supplémentaires tels que MariaDB/MySQL.
Pour un petit serveur privé, un ancien PC de jeu peut convenir, mais les performances du processeur sur un seul thread et la marge disponible en RAM comptent davantage que le simple respect d’une ancienne liste de configuration minimale.
Les frameworks FiveM peuvent nécessiter une base de données distincte
Si vous installez ESX, QBCore ou un autre framework, le conteneur FiveM peut devoir accéder à un conteneur MariaDB/MySQL. Placez les deux services sur un réseau Docker défini par l’utilisateur afin qu’ils puissent communiquer via un nom de service stable plutôt que par des adresses IP de conteneur susceptibles de changer.
Conservez les données de la base de données dans son propre répertoire AppData persistant de CasaOS et sauvegardez-les indépendamment des fichiers de FXServer.
Testez sur le réseau local avant d’ouvrir le serveur sur Internet
Commencez par un test local :
- Vérifiez que le conteneur FiveM reste en cours d’exécution.
- Ouvrez txAdmin à l’adresse
http://CASAOS_IP:40120si l’image utilise le port par défaut. - Terminez la configuration de txAdmin.
- Confirmez
30120/TCPet30120/UDPsont mappés. - Connectez-vous depuis un autre appareil du réseau local.
- Ce n’est qu’après les tests en local que vous devez configurer les règles du routeur ou du pare-feu si des joueurs sur Internet doivent y accéder.
L’hébergement sur Internet implique des responsabilités supplémentaires en matière de sécurité
Un serveur de jeu public reçoit du trafic Internet non sollicité. Gardez CasaOS lui-même, SSH, l’API Docker et les ports de base de données privés. N’exposez que les ports requis par FXServer/txAdmin et envisagez de restreindre l’accès à txAdmin plutôt que de laisser son interface de gestion largement ouverte.
N’exposez pas directement MariaDB/MySQL sur Internet simplement parce que FiveM nécessite une base de données.
Liste de contrôle du serveur FiveM sur CasaOS
- Vérifiez que l’hôte dispose de suffisamment de CPU, de RAM et d’espace de stockage.
- Créez une clé de licence de serveur Cfx.re.
- Choisissez une image Docker FiveM/FXServer maintenue ou créez vous-même l’image à partir des artefacts actuels.
- Conservez la configuration et txData en dehors du conteneur.
- Exposez
30120/TCPet30120/UDP. - N’exposez txAdmin que si nécessaire.
- Effectuez un test en local avant de configurer les règles publiques du pare-feu ou du NAT.
- Sauvegardez txData, les ressources, server.cfg et toute base de données externe.
- Attendez-vous à des différences de compatibilité Linux/Docker par rapport à FXServer sous Windows.
FAQ sur FiveM sur CasaOS
FiveM peut-il fonctionner sur CasaOS ?
Oui. Le fil de discussion source fournissait une architecture Docker fonctionnelle pour une application CasaOS personnalisée. L’image du conteneur elle-même était tierce, et non un paquet officiel de CasaOS.
spritsail/fivem est-elle une image officielle de Cfx.re ?
Non. Il s’agit d’une image Docker tierce référencée par la communauté. Vérifiez son état de maintenance actuel avant de l’utiliser.
Quels ports dois-je mapper ?
La configuration source utilisée 30120/TCP, 30120/UDP, et 40120/TCP pour txAdmin.
Linux/Docker est-il aussi bien pris en charge que Windows ?
Pas exactement. La documentation actuelle de Cfx.re décrit explicitement FXServer sous Linux comme un port fourni à titre gracieux et indique que Windows est plus susceptible de recevoir des correctifs pour les problèmes de compatibilité.
