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.
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.
- VPS Performance - Ressources dédiées et processeurs rapides, idéal pour FiveM
- VPS NVMe - Pour un petit serveur ou un serveur de test
- Serveurs dédiés Eco - Pour les serveurs avec beaucoup de joueurs
- Serveurs dédiés Performance - Performance maximale
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
sudo apt update && sudo apt upgrade -yInstallation des dépendances
La documentation de txAdmin lance le serveur dans screen, et xz-utils permet d'extraire l'archive :
sudo apt install -y curl tar xz-utils screen ca-certificatesCréation d'un utilisateur dédié
Le serveur ne doit jamais tourner en root. Créez un utilisateur dédié :
sudo adduser --disabled-password --gecos "" fivemPorts 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.
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from VOTRE_IP to any port 40120 proto tcp
sudo ufw reloadAvec iptables
La dernière règle bloque txAdmin pour toutes les autres adresses, tout en laissant fonctionner le tunnel SSH local :
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.v4La 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.
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.confCréation de la clé de licence Cfx.re
Chaque serveur a besoin d'une clé de licence gratuite, qui commence par cfxk_.
- Connectez-vous au portail Cfx.re avec votre compte.
- Ouvrez la page des clés d'enregistrement de serveur.
- Cliquez sur le bouton +, renseignez les informations demandées (nom, slogan, description et langue du serveur), puis cliquez sur Generate Key.
- 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 :
sudo -iu fivem
mkdir -p ~/txDataCréez un script qui télécharge la version recommandée de FXServer. Il servira aussi pour les mises à jour :
nano ~/update-fxserver.sh#!/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 :
chmod +x ~/update-fxserver.sh
~/update-fxserver.sh
ls ~/server
exitLe 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
sudo nano /etc/systemd/system/fivem.serviceContenu du fichier :
[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.targetNe 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
sudo systemctl daemon-reload
sudo systemctl enable fivem.service
sudo systemctl start fivem.serviceCommandes de gestion
# 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.logConfiguration 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 :
ssh -L 40120:127.0.0.1:40120 VOTRE_USER@IP_DU_SERVEURGardez 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 :
sudo grep -a -A2 'PIN below' /home/fivem/fxserver.logAssistant de configuration
- Saisissez le code PIN, puis cliquez sur Link Account et connectez-vous avec votre compte Cfx.re.
- Choisissez le mot de passe administrateur de txAdmin.
- Donnez un nom à votre serveur.
- 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).
- Conservez le dossier de destination proposé, puis passez au Recipe Deployer.
- Collez votre clé
cfxk_, renseignez la base de données si le modèle en demande une, puis cliquez sur Run Recipe. - À 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 :
sudo apt install -y mariadb-server
sudo systemctl enable --now mariadbGénérez un mot de passe sans caractères spéciaux, car il sera placé dans une adresse de connexion :
openssl rand -hex 16Créez la base et son utilisateur, en remplaçant MOT_DE_PASSE_GENERE par ce mot de passe :
sudo mariadbCREATE 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 :
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 :
sudo ss -tulpn | grep -E ':(30120|40120)\b'Depuis votre ordinateur, cette adresse doit renvoyer les informations du serveur au format JSON :
http://IP_DU_SERVEUR:30120/info.jsonVérifiez aussi, depuis une autre connexion que VOTRE_IP, que http://IP_DU_SERVEUR:40120 ne répond pas.
Connexion au serveur
- Lancez FiveM.
- Ouvrez la console avec la touche
F8. - 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 :
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 :
sudo systemctl stop fivem.service
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.serviceFaites 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
sudo nano /usr/local/sbin/backup-fivem.shLaissez DB_NAME vide si vous n'utilisez pas MariaDB :
#!/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 -deletesudo chmod 750 /usr/local/sbin/backup-fivem.sh
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backupsPlanifier la sauvegarde
sudo nano /etc/cron.d/fivem-backup# Sauvegarde chaque nuit à 5 h 30
30 5 * * * root /usr/local/sbin/backup-fivem.shCopiez régulièrement ces archives hors du serveur.
Restaurer une sauvegarde
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.serviceRemplacez 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 :
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.jsonrépond - Vérifiez que 30120 est ouvert en TCP et en UDP
- Vérifiez que la ligne
sv_master1 ""deserver.cfgest 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 avecsudo systemctl status mariadb, et utilisez bien127.0.0.1comme hôteAccess 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