Déployer un serveur FiveM avec txAdmin de zéro

Déployer un serveur FiveM avec txAdmin de zéro

Guide complet pour installer un serveur FiveM (GTA V Roleplay) avec le panel d'administration txAdmin sur un VPS Linux VeryCloud. Couvre l'installation des artifacts, la création de la licence, la configuration MySQL et la sécurisation.

Introduction

FiveM est le mod multijoueur le plus populaire pour GTA V, utilisé par 90% des serveurs Roleplay. txAdmin est l'interface web officielle qui permet d'administrer le serveur, gérer les ressources, monitorer les joueurs et déployer des sauvegardes en un clic.

Ce guide installe un serveur FiveM autonome sur un VPS Linux (recommandé : VPS Ryzen avec 4-8 GB de RAM).

Prérequis

  • VPS Debian 12 ou Ubuntu 22.04+ chez VeryCloud
  • Minimum 4 GB de RAM, 8 GB recommandés pour 32+ joueurs
  • Accès root via SSH
  • Une licence Cfx.re (gratuite, créée plus bas)
  • Connexion stable au DNS

Étape 1 : Mise à jour et dépendances

sudo apt update && sudo apt upgrade -y
sudo apt install -y xz-utils curl wget screen git unzip mariadb-server

Étape 2 : Créer un utilisateur dédié

Ne lancez jamais FiveM en root :

sudo useradd -m -s /bin/bash fivem
sudo passwd fivem
sudo su - fivem

Étape 3 : Télécharger les artifacts FiveM

Allez sur https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/ et copiez l'URL du dernier build recommended.

mkdir -p ~/server && cd ~/server
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/XXXX-XXXX/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

Remplacez XXXX-XXXX par le numéro de build (ex: 8761-abc123def).

Étape 4 : Créer le dossier server-data

mkdir -p ~/server-data
cd ~/server-data
git clone https://github.com/citizenfx/cfx-server-data.git .

Ce dépôt contient les ressources par défaut nécessaires au serveur (chat, sessionmanager, spawnmanager, etc.).

Étape 5 : Configurer la base de données

Repassez root et configurez MariaDB :

sudo mysql_secure_installation

Répondez aux questions (mot de passe root MariaDB, supprimer les utilisateurs anonymes, etc.).

Créez la base et l'utilisateur :

sudo mysql -u root -p
CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'MotDePasseSecurise!';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Étape 6 : Obtenir une licence Cfx.re

Rendez-vous sur : https://keymaster.fivem.net

Connectez-vous (compte Discord ou Forum FiveM), puis + New Server Key :

  • Server Hostname : mon-serveur.com ou l'IP de votre VPS
  • Server Type : Server-side (la plupart du temps)

Vous obtenez une clé du format XXXXXXXX.XXXXXXXX.XXXXXXXX.XXXX. Conservez-la précieusement.

Étape 7 : Premier lancement avec txAdmin

Repassez user fivem :

sudo su - fivem
cd ~/server-data
~/server/run.sh

txAdmin s'affiche dans la console avec une URL temporaire de configuration, du type :

http://IP_DE_VOTRE_VPS:40120/addMaster/pin?pin=XXXX

Ouvrez-la dans votre navigateur. Si vous êtes derrière un firewall, ouvrez le port 40120 :

sudo ufw allow 40120/tcp
sudo ufw allow 30120/tcp  # port FiveM par défaut
sudo ufw allow 30120/udp

Étape 8 : Configurer txAdmin via le navigateur

L'interface vous guide :

  1. PIN : entrez celui affiché dans la console
  2. Compte Cfx.re : connectez-vous (recommandé) ou créez un compte local
  3. Nouveau serveur :
    • Nom : MonServeur RP
    • Template : choisissez qbcore ou esx selon le framework souhaité, ou vMenu pour un freeroam minimaliste
  4. Server data folder : /home/fivem/server-data
  5. License key : collez la clé Cfx.re obtenue à l'étape 6
  6. Database : localhost, port 3306, user fivem, mot de passe, base fivem

txAdmin télécharge et configure automatiquement les ressources du framework choisi.

Étape 9 : Démarrer le serveur

Sur l'interface txAdmin : cliquez sur Start Server. Le serveur boot en 30-60 secondes.

Vous voyez les logs en direct. Le serveur est désormais accessible :

  • F8 dans GTA V : connect IP_DE_VOTRE_VPS
  • Ou via la liste publique si vous l'avez activée

Étape 10 : Configurer le service systemd

Pour que FiveM démarre automatiquement et redémarre en cas de crash, créez un service systemd :

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

Contenu :

[Unit]
Description=FiveM Server (txAdmin)
After=network.target mariadb.service

[Service]
Type=simple
User=fivem
WorkingDirectory=/home/fivem/server-data
ExecStart=/home/fivem/server/run.sh
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

Activez :

sudo systemctl daemon-reload
sudo systemctl enable --now fivem
sudo systemctl status fivem

Étape 11 : Sécuriser txAdmin

Le port 40120 est exposé publiquement par défaut. Restreignez-le à votre IP fixe :

sudo ufw delete allow 40120/tcp
sudo ufw allow from VOTRE_IP_FIXE to any port 40120

Ou exposez-le derrière un reverse proxy Nginx avec SSL :

server {
    listen 80;
    server_name admin.mon-serveur.com;

    location / {
        proxy_pass http://127.0.0.1:40120;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

Et ajoutez SSL avec Certbot (voir tuto Nginx Proxy Manager).

Étape 12 : Sauvegarder régulièrement

Créez un script de backup :

sudo nano /usr/local/bin/backup-fivem.sh
#!/bin/bash
BACKUP_DIR=/backup/fivem
DATE=$(date +%F_%H%M)
mkdir -p $BACKUP_DIR

# Backup data + resources
tar -czf $BACKUP_DIR/server-data-$DATE.tar.gz /home/fivem/server-data

# Backup database
mysqldump -u fivem -p'MotDePasseSecurise!' fivem | gzip > $BACKUP_DIR/db-$DATE.sql.gz

# Garde 7 jours
find $BACKUP_DIR -mtime +7 -delete
sudo chmod +x /usr/local/bin/backup-fivem.sh
sudo crontab -e
0 4 * * * /usr/local/bin/backup-fivem.sh

Dépannage

"Couldn't load resource: chat / spawnmanager / etc."

Le dossier server-data est incomplet. Re-clonez :

cd ~/server-data
git pull origin master

Erreur "MySQL connection refused"

Vérifiez le statut MariaDB :

sudo systemctl status mariadb

Et les credentials dans la config txAdmin.

Le serveur n'est pas visible dans la liste publique

Vérifiez server.cfg :

sets sv_listingHostOverride "IP_PUBLIQUE:30120"
sv_lan false

Erreur 401 Cfx.re (License invalid)

Vérifiez que la license correspond bien à l'IP du VPS (sur keymaster.fivem.net). Sinon, créez une nouvelle clé avec la bonne IP.

Commandes utiles

# Statut du service
sudo systemctl status fivem

# Logs en direct
sudo journalctl -u fivem -f

# Redémarrer
sudo systemctl restart fivem

# Mettre à jour les artifacts FiveM
cd ~/server
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/XXXX-XXXX/fx.tar.xz
tar xf fx.tar.xz && rm fx.tar.xz
sudo systemctl restart fivem

# Console live txAdmin
# (via le panel web → Live Console)

# Lister les ressources installées
ls ~/server-data/resources/[local]

Conclusion

Votre serveur FiveM est désormais opérationnel avec txAdmin. Prochaines étapes typiques :

  • Installer des ressources Roleplay (qb-core, ESX, vMenu, etc.)
  • Configurer le whitelist Discord pour gérer l'accès
  • Mettre en place un anti-cheat (BadgerLogs, FiveGuard)
  • Optimiser les performances avec OneSync activé pour 32+ joueurs

Pour des installations clé en main avec support, VeryCloud propose des offres Gaming FiveM dédiées avec txAdmin pré-installé sur panel.verycloud.fr.

Ressources

Join our Discord community server

For any questions, suggestions, or just to chat with the community, join us on Discord!

900+Members