HZ Scripts
server setup

Guide txAdmin 2026 : installer, configurer et gerer votre serveur FiveM

HitzyMay 26, 202613 min read
txadminfivemfivem serverserver managementserver setup

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

  1. Qu'est-ce que txAdmin ?
  2. Installer txAdmin (Windows & Linux)
  3. Assistant de premiere configuration
  4. Comprendre le tableau de bord txAdmin
  5. Configurer server.cfg via txAdmin
  6. Gerer les ressources
  7. Administration des joueurs
  8. Redemarrages automatiques et sauvegardes
  9. Permissions et roles admin
  10. Resolution des problemes courants
  11. 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.cfg avec 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
Sans txAdmin, vous gereriez votre serveur via des commandes console brutes — possible, mais penible. txAdmin est le standard.

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

  1. Installez Git et 7-Zip si ce n'est pas deja fait.
  2. Rendez-vous sur la page officielle des artefacts FiveM : runtime.fivem.net/artifacts/fivem/build_server_windows/master/
  3. Telechargez le dernier build "recommended" (reperable a l'etiquette verte) — c'est une archive .7z.
  4. Extrayez server.7z dans un dossier (par exemple, C:\FXServer\server).
  5. Lancez FXServer.exe — txAdmin demarrera automatiquement et ouvrira votre navigateur.
  6. 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/ et server.cfg seront 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.
Des recipes communautaires (vMenu, modeles personnalises) peuvent aussi etre disponibles. Notre recommandation : si vous etes un debutant absolu et voulez juste experimenter — utilisez CFX Default FiveM (pas de base de donnees necessaire). Si vous construisez un serveur RP serieux — choisissez une recipe QBCore ou QBox, ou partez d'une installation vierge et installez tout manuellement. Vous comprendrez bien mieux votre stack, ce qui paie quand vous debuggez a 2h du matin.

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 :


  1. Base de donnees (oxmysql — le standard moderne, remplace mysql-async)

  2. Bibliotheques (ox_lib, PolyZone)

  3. Noyau du framework (es_extended, qb-core, qbx_core)

  4. Modules du framework (metiers, banque, inventaire)

  5. Scripts standalone (HZ-Scripts, meteo, TV, audio, etc.)

  6. 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
Redemarrer une ressource individuelle est bien plus rapide que redemarrer l'ensemble du serveur. Utilisez cela constamment pendant le developpement.

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 (souvent ox_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 dans server.cfg sont 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 :


  1. Cliquez sur "Add Admin"

  2. Entrez leur nom d'utilisateur/email

  3. Assignez un role

  4. 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_licenseKey invalide — 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
Solution : demarrez avec un 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
Solution : connectez-vous en SSH a votre serveur, verifiez 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
Solution : lisez la console serveur au moment ou le joueur tente de se connecter. txAdmin vous montre exactement quelle etape a echoue.

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
Solution : testez vos identifiants avec HeidiSQL (inclus avec MariaDB sous Windows) ou DBeaver. S'ils fonctionnent la, le probleme vient de la syntaxe de votre server.cfg.

Et ensuite ?

Maintenant que vous maitrisez txAdmin de A a Z :

  1. Choisissez votre framework judicieusementComparatif ESX vs QBCore vs QBox
  2. Selectionnez vos premiers scriptsPremiers scripts a installer sur votre serveur FiveM
  3. Constituez votre catalogue de scripts — parcourez HZ-Scripts pour des ressources premium pret-a-l'emploi
txAdmin est la piece la plus sous-estimee de l'ecosysteme FiveM. Maitrisez-le tot — vous vous en feliciterez quand vous debuggerez un serveur 64 joueurs a 2h du matin avec un Discord communautaire en emeute demandant "c'est revenu ?"

FAQ

Consultez la FAQ ci-dessus pour chaque section, ou parcourez les guides associes pour des sujets specifiques.

Frequently Asked Questions