Guide txAdmin 2026 : installer, configurer et gerer votre serveur FiveM
Si vous configurez un serveur FiveM, vous allez passer beaucoup de temps dans txAdmin. C'est le panneau de gestion web qui gere tout, du demarrage de votre serveur au bannissement des joueurs toxiques. Bien le maitriser vous fera economiser des heures de debugging.
Ce guide couvre tout, de votre premier lancement de txAdmin a la configuration avancee — redemarrages automatiques, sauvegardes, gestion des ressources et permissions admin.
Si vous n'avez pas encore mis en place votre serveur FiveM, commencez par notre Guide complet pour creer un serveur FiveM.
Table des matieres
- Qu'est-ce que txAdmin ?
- Installer txAdmin (Windows & Linux)
- Assistant de premiere configuration
- Comprendre le tableau de bord txAdmin
- Configurer server.cfg via txAdmin
- Gerer les ressources
- Administration des joueurs
- Redemarrages automatiques et sauvegardes
- Permissions et roles admin
- Resolution des problemes courants
- FAQ
Qu'est-ce que txAdmin ?
txAdmin est le panneau de gestion officiel des serveurs FiveM. Il est developpe par l'equipe CFX.re et est fourni avec chaque build serveur FiveM.Il offre une interface web (accessible a l'adresse http://VOTRE_IP:40120) qui vous permet de :
- Demarrer, arreter et redemarrer votre serveur en un clic
- Acceder a la console serveur en direct depuis votre navigateur
- Editer
server.cfgavec coloration syntaxique - Parcourir, demarrer et arreter des ressources individuelles
- Bannir, expulser et avertir des joueurs
- Configurer des redemarrages planifies et des sauvegardes automatiques
- Gerer plusieurs comptes admin avec des permissions basees sur des roles
- Consulter les metriques du serveur (CPU, RAM, nombre de joueurs) en temps reel
Installer txAdmin
txAdmin est integre au serveur FiveM. Vous n'installez pas txAdmin separement — vous telechargez le build du serveur FiveM, et txAdmin se lance automatiquement.
Installation sous Windows
- Installez Git et 7-Zip si ce n'est pas deja fait.
- Rendez-vous sur la page officielle des artefacts FiveM : runtime.fivem.net/artifacts/fivem/build_server_windows/master/
- Telechargez le dernier build "recommended" (reperable a l'etiquette verte) — c'est une archive
.7z. - Extrayez
server.7zdans un dossier (par exemple,C:\FXServer\server). - Lancez
FXServer.exe— txAdmin demarrera automatiquement et ouvrira votre navigateur. - Entrez le code PIN affiche dans la console, cliquez sur Link Account et authentifiez-vous avec votre compte CFX.re.
Installation sous Linux
Pour la production, Linux est recommande (meilleures performances, mises a jour plus simples, consommation memoire reduite).
# Prerequisites
sudo apt install git xz-utils
Create a dedicated user
sudo adduser fivem
sudo su - fivem
Download FXServer
mkdir -p ~/FXServer/server
cd ~/FXServer/server
Replace LATEST_LINK with the actual URL from the artifacts page
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/LATEST_LINK
tar xf fx.tar.xz --strip-components=1
rm fx.tar.xz
Start FXServer
bash run.sh +exec server.cfg
Remplacez LATEST_LINK par l'URL reelle de telechargement depuis la page d'artefacts Linux. Choisissez le dernier build recommande.
Apres le demarrage, vous verrez la meme URL txAdmin. Ouvrez-la dans votre navigateur.
A propos de l'utilisation de txAdmin derriere un reverse proxy
Si vous souhaitez une URL propre comme panel.votreserveur.com au lieu de votre-ip:40120, configurez Nginx ou Caddy en reverse proxy. Cela vous permet aussi d'activer HTTPS via Let's Encrypt. Recommande pour tout serveur accessible publiquement.
Assistant de premiere configuration
Au premier lancement, txAdmin vous guide a travers un assistant en 4 etapes.
Etape 1 — Creer votre compte admin principal
Vous allez creer le compte admin principal de txAdmin. Ce compte dispose de toutes les permissions sur le panneau. Choisissez un mot de passe solide — quiconque possede cet identifiant controle l'integralite de votre serveur.
Vous pouvez aussi vous connecter via votre compte Discord ou CFX.re en OAuth. Recommande pour la securite (pas de mot de passe a compromettre).
Etape 2 — Lier votre compte CFX.re
txAdmin vous demandera de l'autoriser avec votre compte CFX.re. Cela connecte votre serveur a votre cle de licence CFX.re pour une authentification correcte.
Etape 3 — Configuration du serveur
On vous demandera :
- Nom du serveur (par exemple, "Mon Super Serveur RP")
- Dossier du serveur — ou vos
resources/etserver.cfgseront stockes - Chemin des donnees serveur — ou txAdmin stocke ses donnees (logs, sauvegardes, etc.)
Etape 4 — Choisir une recipe (ou passer cette etape)
C'est la decision importante : voulez-vous que txAdmin installe automatiquement un serveur de base pour vous, ou preferez-vous partir de zero ?
Selectionnez "Popular Recipes" pour voir les modeles disponibles. La liste varie dans le temps, mais les options courantes incluent :
- CFX Default FiveM — installation minimale par defaut, aucune base de donnees requise. Ideal pour une premiere experimentation.
- QBCore — framework QBCore complet + scripts essentiels. Necessite MariaDB.
- ESX Legacy — framework ESX complet + scripts essentiels. Necessite MariaDB.
- QBox — framework QBox complet. Necessite MariaDB.
Apres cette etape, txAdmin finalise l'installation et demarre votre serveur. Vous devriez voir "Server started" dans la console.
Comprendre le tableau de bord txAdmin
Une fois connecte, vous verrez le tableau de bord principal de txAdmin. Passons en revue chaque section.
Barre d'en-tete
La barre superieure affiche :
- Statut du serveur (En ligne/Hors ligne avec le nombre de joueurs)
- Temps de fonctionnement du serveur
- Utilisation CPU et RAM
- Boutons d'action rapide (Demarrer, Arreter, Redemarrer le serveur)
Barre laterale gauche
- Dashboard — metriques generales et actions rapides
- Players — joueurs connectes + base de donnees de tous les joueurs
- History — historique des actions admin (bans, kicks, warns)
- Whitelist — si la liste blanche est activee
- Resources — demarrer/arreter/redemarrer des scripts individuels
- Server Log — sortie console en temps reel
- Server.cfg Editor — editez votre fichier de configuration principal avec coloration syntaxique
- txAdmin Settings — configurez le panneau lui-meme
Console en direct
La Console en direct est l'endroit ou vous passerez le plus de temps a debugger. Elle affiche en temps reel la sortie du serveur : messages de chat, erreurs, avertissements de ressources, connexions de joueurs.
Vous pouvez taper des commandes serveur directement dans la console — tout ce que vous taperiez via SSH fonctionne ici. Exemples :
ensure hz-weather # start a resource
restart hz-weather # restart a resource
stop hz-weather # stop a resource
status # show server status
players # list connected players
quit # stop the server
Configurer server.cfg via txAdmin
Votre server.cfg est le coeur de votre serveur FiveM. Il controle le nom d'hote, le nombre de slots, la cle de licence, les permissions admin et les ressources a demarrer.
L'editeur integre de txAdmin inclut la coloration syntaxique et un bouton "Save & Restart".
Parametres essentiels de server.cfg
Voici un server.cfg minimal pour demarrer :
# License key from portal.cfx.re
sv_licenseKey "your-key-here"
Server identity
sv_hostname "^1My ^7Awesome ^2RP Server"
sv_projectName "MyServer"
sv_projectDesc "A friendly RP community"
sv_maxClients 48
Endpoint settings
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
Server tags (for the FiveM browser)
sets tags "roleplay, qbcore, custom"
sets locale "en-US"
Database connection (MariaDB — for ESX/QBCore/QBox)
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"
OneSync (required for server-side player awareness)
set onesync on
Resources — order matters
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure pma-voice
ensure hz-weather
ensure hz-television
... add more resources here
Ordre de chargement des ressources
Les ressources sont chargees dans l'ordre ou elles apparaissent dans server.cfg. Les dependances doivent venir en premier.
Ordre courant :
- Base de donnees (
oxmysql— le standard moderne, remplacemysql-async) - Bibliotheques (
ox_lib,PolyZone) - Noyau du framework (
es_extended,qb-core,qbx_core) - Modules du framework (metiers, banque, inventaire)
- Scripts standalone (HZ-Scripts, meteo, TV, audio, etc.)
- En dernier (outils d'administration, mods optionnels)
Si vous faites un
ensure d'un script avant sa dependance, vous verrez des erreurs au demarrage. Lire la console attentivement vous indique ce qui manque.
Gerer les ressources
L'onglet Resources dans txAdmin liste chaque ressource de votre dossier resources/, avec son statut (demarree/arretee) et son heure de demarrage.
Demarrer/arreter/redemarrer depuis le panneau
Cliquez sur n'importe quelle ressource et utilisez les boutons :
- Start — equivalent a
ensure resource_name - Stop — equivalent a
stop resource_name - Restart — arret puis redemarrage
Rafraichir la liste des ressources
Si vous deposez un nouveau dossier de ressource dans resources/ et qu'il n'apparait pas dans le panneau, cliquez sur "Refresh". Cela relance l'analyse du dossier.
Erreurs de ressource courantes
La plupart des erreurs de ressource apparaissent dans la console avec les etiquettes [ERROR] ou [WARN] :
Could not find dependency— une ressource requise n'est pas en cours d'execution. Verifiez la documentation de la ressource pour connaitre ses dependances (souventox_lib,oxmysql).Script error: attempt to index a nil value— bug dans le script Lua. Lisez le numero de ligne, ouvrez le fichier, investiguez.oxmysql: no connection— vos identifiants MariaDB/MySQL dansserver.cfgsont incorrects ou la base de donnees ne tourne pas.
Administration des joueurs
L'onglet Players affiche tous les joueurs connectes, ainsi qu'une base de donnees consultable de tous les joueurs ayant rejoint le serveur.
Actions rapides par joueur
Faites un clic droit sur n'importe quel joueur pour :
- Kick (avec motif)
- Warn (enregistre dans son historique)
- Ban (temporaire ou permanent)
- DM (message direct en jeu)
- Spectate (observer son gameplay)
- Teleport (outil admin)
Bannissements
Les bannissements txAdmin enregistrent la licence, l'IP, l'identifiant materiel, Steam, Discord et Xbox Live du joueur. Un joueur banni ne peut pas revenir simplement en changeant d'IP ou de compte Steam — a moins de spoofer l'integralite de son identifiant materiel.
Pour une efficacite maximale, appliquez les bans via txAdmin (et non via des commandes de chat en jeu) afin qu'ils soient persistes dans la base de donnees de txAdmin.
Redemarrages automatiques et sauvegardes
Deux fonctionnalites que tout serveur doit activer : les redemarrages planifies et les sauvegardes automatiques.
Redemarrages planifies
Les serveurs FiveM accumulent lentement de la memoire au fil du temps. Un redemarrage propre toutes les 6 a 12 heures maintient des performances stables.
Dans Settings — Restarter :
- Activez "Scheduled Restarts"
- Definissez les horaires de redemarrage (par exemple, 06:00, 18:00 heure du serveur)
- Configurez les avertissements : txAdmin diffusera des messages en jeu 30, 15 et 5 minutes avant le redemarrage
Sauvegardes automatiques
txAdmin peut sauvegarder votre dossier server-data + base de donnees MariaDB selon un planning.
Dans Settings — Backup :
- Activez "Auto Backup"
- Definissez la frequence (quotidienne recommandee)
- Definissez la retention (conservez 7 a 14 jours de sauvegardes)
- Specifiez la destination des sauvegardes (dossier local ou stockage compatible S3)
Configurez les sauvegardes MariaDB separement via votre hebergeur ou avec un cron
mariadb-dump personnalise. txAdmin ne sauvegarde pas la base de donnees automatiquement par defaut.
Permissions et roles admin
txAdmin utilise un systeme de permissions base sur les roles. Les roles par defaut :
- Owner — acces complet a tout (le premier admin)
- Admin — peut gerer les joueurs, redemarrer les ressources, editer server.cfg
- Moderator — peut kick/ban les joueurs, consulter les logs, mais ne peut pas modifier la configuration du serveur
- Roles personnalises — vous pouvez definir les votres
Ajouter de nouveaux admins
Dans Settings — Admin Management :
- Cliquez sur "Add Admin"
- Entrez leur nom d'utilisateur/email
- Assignez un role
- Ils recevront un lien d'invitation pour definir leur mot de passe
Discord OAuth (recommande)
Lier les comptes admin a Discord OAuth est plus securise que les mots de passe :
- Pas de mot de passe a compromettre
- Revocation plus simple (il suffit de retirer l'acces Discord)
- Meilleure tracabilite (noms d'utilisateur Discord dans les logs)
Configurez cela dans Settings — Authentication.
Resolution des problemes courants
Le serveur ne demarre pas
Symptome : txAdmin affiche "Server start failed" ou reste bloque au demarrage. Causes :sv_licenseKeyinvalide — verifiez-la sur portal.cfx.re- Conflit de port — un autre processus utilise le port 30120
- Crash d'une ressource au chargement — verifiez dans la console la derniere ressource chargee
server.cfg minimal (aucune ressource sauf mapmanager, chat, spawnmanager). Rajoutez les ressources une par une jusqu'a trouver la fautive.
Impossible de se connecter au panneau web txAdmin
Symptome :http://votre-ip:40120 ne charge pas.
Causes :
- Le pare-feu bloque le port 40120
- txAdmin ne tourne pas (serveur non demarre)
- Mauvaise IP
netstat -tulpn | grep 40120 (Linux) pour confirmer que txAdmin ecoute. Ouvrez le port dans votre pare-feu (ufw allow 40120/tcp sous Ubuntu).
Les joueurs ne peuvent pas se connecter
Symptome : les joueurs obtiennent des erreurs "Couldn't load resource" ou "Connection lost". Causes :- Une ressource n'a pas reussi a se charger — verifiez la console pour
[ERROR] - Le serveur est plein — verifiez
sv_maxClients - Le GTA V du joueur n'est pas a jour — demandez-lui de mettre a jour
Erreurs de connexion MariaDB
Symptome :oxmysql: connection refused ou Access denied.
Causes :
- Chaine de connexion incorrecte dans
server.cfg - Le serveur MariaDB ne tourne pas
- Mauvaises permissions utilisateur
server.cfg.
Et ensuite ?
Maintenant que vous maitrisez txAdmin de A a Z :
- Choisissez votre framework judicieusement — Comparatif ESX vs QBCore vs QBox
- Selectionnez vos premiers scripts — Premiers scripts a installer sur votre serveur FiveM
- Constituez votre catalogue de scripts — parcourez HZ-Scripts pour des ressources premium pret-a-l'emploi
FAQ
Consultez la FAQ ci-dessus pour chaque section, ou parcourez les guides associes pour des sujets specifiques.
