FR

Serveurs de jeux

Comment créer un serveur FiveM avec txAdmin

Guide complet pour installer un serveur FiveM sur un VPS ou serveur dédié Linux avec txAdmin : clé de licence Cfx.re, service systemd, pare-feu, base MariaDB, mises à jour et sauvegardes.

11 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide vous explique comment installer un serveur FiveM (FXServer) sur votre VPS ou serveur dédié Linux, le configurer avec txAdmin, son interface d'administration web, et le faire tourner en service sous un utilisateur dédié.

Commander un serveur

Pour héberger votre serveur FiveM, HostMyServers propose plusieurs offres. Un serveur avec un framework de type roleplay et de nombreuses ressources demande un processeur rapide et de la mémoire.

Prérequis

  • Accès SSH root ou utilisateur avec sudo
  • Système Linux 64 bits x86_64 (Debian 12/13 ou Ubuntu 22.04/24.04), les processeurs ARM ne sont pas pris en charge
  • Pare-feu actif : nftables, iptables ou ufw (n'utilisez qu'un seul outil à la fois)
  • Un compte Cfx.re pour créer la clé de licence du serveur
  • Une copie légitime de GTA V pour chaque joueur
  • Ports 30120 TCP et UDP accessibles, et port 40120 TCP (txAdmin) limité à votre adresse IP

Configuration requise

Cfx.re ne publie pas de configuration minimale pour le serveur. Les valeurs ci-dessous sont des repères à adapter selon vos ressources et le nombre de joueurs.

Usage CPU RAM Stockage
Serveur de base ou de test 2 cœurs rapides 4 Go 20 Go SSD
Framework roleplay, jusqu'à 48 joueurs 4 cœurs rapides 8 Go 40 Go SSD NVMe
Serveur chargé, nombreuses ressources 6 cœurs ou plus 16 Go et plus 80 Go SSD NVMe

Mise à jour du système

Terminal
sudo apt update && sudo apt upgrade -y

Installation des dépendances

La documentation de txAdmin lance le serveur dans screen, et xz-utils permet d'extraire l'archive :

Terminal
sudo apt install -y curl tar xz-utils screen ca-certificates

Création d'un utilisateur dédié

Le serveur ne doit jamais tourner en root. Créez un utilisateur dédié :

Terminal
sudo adduser --disabled-password --gecos "" fivem

Ports utilisés

Port Protocole Utilisation Accès
30120 TCP et UDP Jeu (connexion des joueurs et informations du serveur) Public
40120 TCP Interface web txAdmin Votre adresse IP uniquement
3306 TCP MariaDB, si vous l'installez Local uniquement, ne l'ouvrez pas

Configuration du pare-feu

Ouvrez le port du jeu et limitez txAdmin à votre adresse IP fixe : remplacez VOTRE_IP. Si vous n'avez pas d'adresse fixe, ne créez pas la règle d'autorisation de VOTRE_IP et passez par le tunnel SSH décrit plus bas.

Avec UFW

UFW refuse par défaut les connexions entrantes une fois activé. Vérifiez qu'il est actif avec sudo ufw status.

Terminal
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from VOTRE_IP to any port 40120 proto tcp
sudo ufw reload

Avec iptables

La dernière règle bloque txAdmin pour toutes les autres adresses, tout en laissant fonctionner le tunnel SSH local :

Terminal
sudo iptables -A INPUT -p tcp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30120 -j ACCEPT
sudo iptables -A INPUT -p tcp -s VOTRE_IP --dport 40120 -j ACCEPT
sudo iptables -A INPUT ! -i lo -p tcp --dport 40120 -j DROP
sudo iptables-save | sudo tee /etc/iptables/rules.v4

La sauvegarde des règles au redémarrage nécessite le paquet iptables-persistent.

Avec nftables

Ces commandes utilisent la table inet filter et la chaîne input, présentes par défaut dans /etc/nftables.conf sous Debian.

Terminal
sudo nft add rule inet filter input tcp dport 30120 accept
sudo nft add rule inet filter input udp dport 30120 accept
sudo nft add rule inet filter input ip saddr VOTRE_IP tcp dport 40120 accept
sudo nft add rule inet filter input iifname != "lo" tcp dport 40120 drop
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Création de la clé de licence Cfx.re

Chaque serveur a besoin d'une clé de licence gratuite, qui commence par cfxk_.

  1. Connectez-vous au portail Cfx.re avec votre compte.
  2. Ouvrez la page des clés d'enregistrement de serveur.
  3. Cliquez sur le bouton +, renseignez les informations demandées (nom, slogan, description et langue du serveur), puis cliquez sur Generate Key.
  4. Copiez la clé avec Copy Key et gardez-la pour l'étape de configuration.

Installation de FXServer

Connectez-vous en tant qu'utilisateur fivem et créez le dossier des données de txAdmin :

Terminal
sudo -iu fivem
mkdir -p ~/txData

Créez un script qui télécharge la version recommandée de FXServer. Il servira aussi pour les mises à jour :

Terminal
nano ~/update-fxserver.sh
Terminal
#!/bin/bash
set -euo pipefail

API="https://changelogs-live.fivem.net/api/changelog/versions/linux/server"
URL=$(curl -fsSL "$API" | grep -o '"recommended_download":"[^"]*"' | cut -d'"' -f4)
[ -n "$URL" ] || { echo "Adresse de téléchargement introuvable" >&2; exit 1; }

TMP=$(mktemp -d "$HOME/fxserver.XXXXXX")
trap 'rm -rf "$TMP"' EXIT

curl -fL -o "$TMP/fx.tar.xz" "$URL"
tar -xJf "$TMP/fx.tar.xz" -C "$TMP"
rm -f "$TMP/fx.tar.xz"

rm -rf "$HOME/server"
mkdir -p "$HOME/server"
mv "$TMP"/* "$HOME/server/"

echo "Version installée : $URL"

Lancez-le, puis quittez la session de l'utilisateur fivem :

Terminal
chmod +x ~/update-fxserver.sh
~/update-fxserver.sh
ls ~/server
exit

Le dossier ~/server doit contenir run.sh et alpine. Si vous préférez choisir la version vous-même, les archives sont listées sur la page de téléchargement officielle.

Configuration en tant que service systemd

Créer le fichier de service

Terminal
sudo nano /etc/systemd/system/fivem.service

Contenu du fichier :

Configuration
[Unit]
Description=FiveM Server (FXServer + txAdmin)
After=network-online.target mariadb.service
Wants=network-online.target

[Service]
Type=simple
User=fivem
Group=fivem
WorkingDirectory=/home/fivem/txData
Environment=TERM=xterm
Environment=TXHOST_DATA_PATH=/home/fivem/txData
Environment=TXHOST_TXA_PORT=40120
Environment=TXHOST_GAME_NAME=fivem
ExecStartPre=/usr/bin/truncate -s 0 /home/fivem/fxserver.log
ExecStart=/usr/bin/screen -L -Logfile /home/fivem/fxserver.log -DmS fivem /home/fivem/server/run.sh
Restart=always
RestartSec=15
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

Ne passez pas d'argument +exec à run.sh : il empêcherait le démarrage de txAdmin.

Variable Rôle
TXHOST_DATA_PATH Dossier des données de txAdmin, séparé des fichiers de FXServer pour survivre aux mises à jour
TXHOST_TXA_PORT Port de l'interface web (40120 par défaut)
TXHOST_GAME_NAME Limite txAdmin aux modèles FiveM

Activer et démarrer le service

Terminal
sudo systemctl daemon-reload
sudo systemctl enable fivem.service
sudo systemctl start fivem.service

Commandes de gestion

Terminal
# Vérifier le statut
sudo systemctl status fivem.service

# Arrêter le serveur
sudo systemctl stop fivem.service

# Redémarrer le serveur
sudo systemctl restart fivem.service

# Suivre la console
sudo tail -f /home/fivem/fxserver.log

Configuration avec txAdmin

Accéder à l'interface

La méthode la plus sûre est un tunnel SSH, car le trafic reste chiffré et aucun port d'administration n'a besoin d'être ouvert. Depuis votre ordinateur :

Terminal
ssh -L 40120:127.0.0.1:40120 VOTRE_USER@IP_DU_SERVEUR

Gardez cette session ouverte, puis ouvrez http://127.0.0.1:40120 dans votre navigateur. Si vous avez autorisé VOTRE_IP dans le pare-feu, vous pouvez aussi utiliser http://IP_DU_SERVEUR:40120.

Récupérer le code PIN

Au premier démarrage, txAdmin affiche un code PIN à 4 chiffres. Patientez une quinzaine de secondes, puis affichez-le sur le serveur :

Terminal
sudo grep -a -A2 'PIN below' /home/fivem/fxserver.log

Assistant de configuration

  1. Saisissez le code PIN, puis cliquez sur Link Account et connectez-vous avec votre compte Cfx.re.
  2. Choisissez le mot de passe administrateur de txAdmin.
  3. Donnez un nom à votre serveur.
  4. Sélectionnez Popular Recipes, puis un modèle. Pour un serveur simple, prenez le modèle de base de Cfx.re (FiveM Basic Server, parfois affiché CFX Default FiveM).
  5. Conservez le dossier de destination proposé, puis passez au Recipe Deployer.
  6. Collez votre clé cfxk_, renseignez la base de données si le modèle en demande une, puis cliquez sur Run Recipe.
  7. À la fin du déploiement, cliquez sur Save & Run Server.

Les fichiers du serveur sont créés dans un sous-dossier de /home/fivem/txData, dont le nom se termine par .base. Le chemin exact est indiqué par txAdmin.

Base de données MariaDB (si nécessaire)

Le modèle de base n'a pas besoin de base de données. Les frameworks comme ESX Legacy ou Qbox en demandent une, et oxmysql, la ressource qu'ils utilisent pour s'y connecter, recommande MariaDB. Installez-la avant de lancer le déploiement :

Terminal
sudo apt install -y mariadb-server
sudo systemctl enable --now mariadb

Générez un mot de passe sans caractères spéciaux, car il sera placé dans une adresse de connexion :

Terminal
openssl rand -hex 16

Créez la base et son utilisateur, en remplaçant MOT_DE_PASSE_GENERE par ce mot de passe :

Terminal
sudo mariadb
SQL
CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'MOT_DE_PASSE_GENERE';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Dans le déploiement txAdmin, indiquez ensuite :

Champ Valeur
Hôte 127.0.0.1
Port 3306
Utilisateur fivem
Mot de passe Le mot de passe généré
Base de données fivem

txAdmin écrit la connexion dans server.cfg, sous cette forme :

Texte
set mysql_connection_string "mysql://fivem:MOT_DE_PASSE_GENERE@127.0.0.1/fivem?charset=utf8mb4"

Vérifier le serveur

Vérifiez que les ports écoutent :

Terminal
sudo ss -tulpn | grep -E ':(30120|40120)\b'

Depuis votre ordinateur, cette adresse doit renvoyer les informations du serveur au format JSON :

Texte
http://IP_DU_SERVEUR:30120/info.json

Vérifiez aussi, depuis une autre connexion que VOTRE_IP, que http://IP_DU_SERVEUR:40120 ne répond pas.

Connexion au serveur

  1. Lancez FiveM.
  2. Ouvrez la console avec la touche F8.
  3. Tapez : connect IP_DU_SERVEUR:30120

Un nouveau serveur peut mettre jusqu'à 8 minutes pour apparaître dans la liste publique.

Administration

L'essentiel se gère depuis txAdmin :

Menu Utilisation
Live Console Console du serveur en direct
CFG Editor Modification de server.cfg
Resources Liste et gestion des ressources
Players Joueurs, avertissements et bannissements
Admins Comptes administrateurs et permissions
Settings Réglages, dont le planning de redémarrage (Restart Schedule)
Master Actions Actions réservées au compte principal

En jeu, ouvrez la console avec F8 et tapez tx pour afficher le menu txAdmin.

Quelques réglages utiles de server.cfg, à modifier dans CFG Editor :

Texte
sv_maxclients 48
sv_endpointPrivacy true
Paramètre Description
sv_maxclients Nombre maximum de joueurs, selon votre abonnement
sv_endpointPrivacy Masque les adresses IP des joueurs dans les informations publiques

Cfx.re indique que le nom et la description du serveur se gèrent désormais depuis le portail. Laissez rcon_password non défini : le RCON reste ainsi désactivé, et Live Console le remplace.

Mise à jour du serveur

Le script installe la dernière version recommandée, sans toucher à txData :

Terminal
sudo systemctl stop fivem.service
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service

Faites une sauvegarde avant chaque mise à jour.

Sauvegarde automatique

txData contient vos ressources, server.cfg et les comptes txAdmin. Les sauvegardes contiennent donc des secrets : gardez-les privées.

Script de sauvegarde

Terminal
sudo nano /usr/local/sbin/backup-fivem.sh

Laissez DB_NAME vide si vous n'utilisez pas MariaDB :

Terminal
#!/bin/bash
set -euo pipefail
umask 027

BACKUP_DIR="/home/fivem/backups"
DB_NAME="fivem"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

install -d -o fivem -g fivem -m 750 "$BACKUP_DIR"

# Fichiers du serveur et de txAdmin, sans les caches
tar --exclude='*/cache' -czf "$BACKUP_DIR/fivem_$DATE.tar.gz" -C /home/fivem txData

# Base de données
if [ -n "$DB_NAME" ]; then
    mariadb-dump --single-transaction "$DB_NAME" | gzip > "$BACKUP_DIR/fivem_db_$DATE.sql.gz"
fi

chown fivem:fivem "$BACKUP_DIR"/fivem_*"$DATE"*

# Supprimer les sauvegardes de plus de 7 jours
find "$BACKUP_DIR" -name "fivem_*.gz" -mtime +7 -delete
Terminal
sudo chmod 750 /usr/local/sbin/backup-fivem.sh
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

Planifier la sauvegarde

Terminal
sudo nano /etc/cron.d/fivem-backup
Texte
# Sauvegarde chaque nuit à 5 h 30
30 5 * * * root /usr/local/sbin/backup-fivem.sh

Copiez régulièrement ces archives hors du serveur.

Restaurer une sauvegarde

Terminal
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.old
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
zcat /home/fivem/backups/fivem_db_DATE.sql.gz | sudo mariadb fivem
sudo systemctl start fivem.service

Remplacez DATE par la date de l'archive, et ignorez la ligne zcat si vous n'utilisez pas de base de données.

En cas de problème

Le service ne démarre pas

  • Consultez le service : sudo journalctl -u fivem.service -n 50
  • Consultez la console : sudo tail -n 100 /home/fivem/fxserver.log
  • Vérifiez que l'architecture est bien x86_64 : uname -m
  • Vérifiez les droits : sudo chown -R fivem:fivem /home/fivem

Failed to start HTTP server, port 40120 is already in use

Une autre instance de txAdmin utilise déjà le port. Identifiez-la :

Terminal
sudo ss -ltnp | grep ':40120'

Si vous avez lancé run.sh à la main, arrêtez ce processus avant de démarrer le service.

Code PIN introuvable

Le code n'est affiché que tant qu'aucun administrateur n'existe. Redémarrez le service, attendez quelques secondes, puis relancez la commande grep. Si un compte existe déjà, connectez-vous avec lui.

Si vous avez perdu le mot de passe du compte principal, arrêtez le service, renommez /home/fivem/txData/admins.json, puis redémarrez : txAdmin propose à nouveau de créer un administrateur.

No license key was specified

La clé est absente ou incorrecte. Vérifiez la ligne sv_licenseKey dans CFG Editor, ou régénérez la clé sur le portail Cfx.re.

Le serveur n'apparaît pas dans la liste

  • Testez la connexion directe avec connect IP_DU_SERVEUR:30120
  • Vérifiez que http://IP_DU_SERVEUR:30120/info.json répond
  • Vérifiez que 30120 est ouvert en TCP et en UDP
  • Vérifiez que la ligne sv_master1 "" de server.cfg est commentée avec #
  • Patientez jusqu'à 8 minutes après le démarrage

Le serveur reste limité à 48 joueurs

Il faut un abonnement Element Club Argentum ou supérieur, un serveur à jour, puis une valeur sv_maxclients adaptée et un redémarrage.

Erreur de connexion à la base de données

  • ECONNREFUSED : vérifiez que MariaDB tourne avec sudo systemctl status mariadb, et utilisez bien 127.0.0.1 comme hôte
  • Access denied : vérifiez l'utilisateur, le mot de passe et le nom de la base
  • Si le mot de passe contient des caractères spéciaux, remplacez-le par une valeur générée avec openssl rand -hex 16

Impossible d'accéder à txAdmin

  • Vérifiez que le service tourne et que le port 40120 écoute
  • Vérifiez que votre adresse IP publique correspond toujours à VOTRE_IP
  • Utilisez le tunnel SSH, qui ne dépend pas de la règle du pare-feu