Guide txAdmin 2026 : installer, configurer et gérer 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 gère tout, du démarrage de votre serveur au bannissement des joueurs toxiques. Bien le maîtriser vous fera économiser des heures de debugging.

Ce guide couvre tout, de votre premier lancement de txAdmin à la configuration avancée — redémarrages 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 créer un serveur FiveM.

Table des matières

1. Qu'est-ce que txAdmin ?
2. Installer txAdmin (Windows & Linux)
3. Assistant de première configuration
4. Comprendre le tableau de bord txAdmin
5. Configurer server.cfg via txAdmin
6. Gérer les ressources
7. Administration des joueurs
8. Redémarrages automatiques et sauvegardes
9. Permissions et rôles admin
10. Résolution des problèmes courants
11. FAQ

Qu'est-ce que txAdmin ?

Il offre une interface web (accessible à l'adresse http://VOTRE_IP:40120) qui vous permet de :

• Démarrer, arrêter et redémarrer votre serveur en un clic
• Accéder à la console serveur en direct depuis votre navigateur
• Éditer server.cfg avec coloration syntaxique
• Parcourir, démarrer et arrêter des ressources individuelles
• Bannir, expulser et avertir des joueurs
• Configurer des redémarrages planifies et des sauvegardes automatiques
• Gérer plusieurs comptes admin avec des permissions basées sur des rôles
• Consulter les métriques du serveur (CPU, RAM, nombre de joueurs) en temps réel

Installer txAdmin

txAdmin est intégré au serveur FiveM. Vous n'installez pas txAdmin séparément — vous téléchargez le build du serveur FiveM, et txAdmin se lance automatiquement.

Installation sous Windows

1. Installez Git et 7-Zip si ce n'est pas déjà fait.
2. Rendez-vous sur la page officielle des artefacts FiveM : runtime.fivem.net/artifacts/fivem/build_server_windows/master/
3. Téléchargez le dernier build "recommended" (reperable à l'étiquette verte) — c'est une archive .7z.
4. Extrayez server.7z dans un dossier (par exemple, C:\FXServer\server).
5. Lancez FXServer.exe — txAdmin démarrera 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 recommandé (meilleures performances, mises à jour plus simples, consommation mémoire réduite).

# 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 réelle de téléchargement depuis la page d'artefacts Linux. Choisissez le dernier build recommande.

Après le démarrage, vous verrez la même URL txAdmin. Ouvrez-la dans votre navigateur.

À propos de l'utilisation de txAdmin derrière 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 première configuration

Au premier lancement, txAdmin vous guide à travers un assistant en 4 étapes.

Étape 1 — Créer votre compte admin principal

Vous allez créer le compte admin principal de txAdmin. Ce compte dispose de toutes les permissions sur le panneau. Choisissez un mot de passe solide — quiconque possède cet identifiant contrôle l'integralite de votre serveur.

Vous pouvez aussi vous connecter via votre compte Discord ou CFX.re en OAuth. Recommande pour la sécurité (pas de mot de passe à compromettre).

Étape 2 — Lier votre compte CFX.re

txAdmin vous demandera de l'autoriser avec votre compte CFX.re. Cela connecte votre serveur à votre clé de licence CFX.re pour une authentification correcte.

Étape 3 — Configuration du serveur

On vous demandera :

• Nom du serveur (par exemple, "Mon Super Serveur RP")
• Dossier du serveur — où vos resources/ et server.cfg seront stockes
• Chemin des données serveur — ou txAdmin stocke ses données (logs, sauvegardes, etc.)

Étape 4 — Choisir une recipe (ou passer cette étape)

C'est la décision importante : voulez-vous que txAdmin installe automatiquement un serveur de base pour vous, ou preferez-vous partir de zéro ?

Sélectionnez "Popular Recipes" pour voir les modèles disponibles. La liste varie dans le temps, mais les options courantes incluent :

• CFX Default FiveM — installation minimale par défaut, aucune base de données requise. Idéal pour une première expérimentation.
• QBCore — framework QBCore complet + scripts essentiels. Nécessite MariaDB.
• ESX Legacy — framework ESX complet + scripts essentiels. Nécessite MariaDB.
• QBox — framework QBox complet. Nécessite MariaDB.

Après cette étape, txAdmin finalise l'installation et démarre votre serveur. Vous devriez voir "Server started" dans la console.

Comprendre le tableau de bord txAdmin

Une fois connecté, vous verrez le tableau de bord principal de txAdmin. Passons en revue chaque section.

Barre d'en-tete

La barre supérieure 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 (Démarrer, Arrêter, Redémarrer le serveur)

Barre latérale gauche

• Dashboard — métriques générales et actions rapides
• Players — joueurs connectes + base de données de tous les joueurs
• History — historique des actions admin (bans, kicks, warns)
• Whitelist — si la liste blanche est activée
• Resources — demarrer/arreter/redemarrer des scripts individuels
• Server Log — sortie console en temps réel
• Server.cfg Editor — éditez votre fichier de configuration principal avec coloration syntaxique
• txAdmin Settings — configurez le panneau lui-même

Console en direct

La Console en direct est l'endroit où vous passerez le plus de temps à debugger. Elle affiche en temps réel 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 contrôle le nom d'hote, le nombre de slots, la clé de licence, les permissions admin et les ressources à démarrer.

L'éditeur intégré de txAdmin inclut la coloration syntaxique et un bouton "Save & Restart".

Paramètres essentiels de server.cfg

Voici un server.cfg minimal pour démarrer :

# 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 chargées dans l'ordre ou elles apparaissent dans server.cfg. Les dépendances doivent venir en premier.

Ordre courant :

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


2. Bibliothèques (ox_lib, PolyZone)


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


4. Modules du framework (métiers, banque, inventaire)


5. Scripts standalone (HZ-Scripts, météo, TV, audio, etc.)


6. En dernier (outils d'administration, mods optionnels)

Gérer les ressources

L'onglet Resources dans txAdmin liste chaque ressource de votre dossier resources/, avec son statut (demarree/arretee) et son heure de démarrage.

Demarrer/arreter/redemarrer depuis le panneau

Cliquez sur n'importe quelle ressource et utilisez les boutons :

• Start — équivalent à ensure resource_name
• Stop — équivalent à stop resource_name
• Restart — arrêt puis redémarrage

Rafraîchir la liste des ressources

Si vous déposez un nouveau dossier de ressource dans resources/ et qu'il n'apparaît 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 étiquettes [ERROR] ou [WARN] :

• Could not find dependency — une ressource requise n'est pas en cours d'execution. Vérifiez la documentation de la ressource pour connaître ses dépendances (souvent ox_lib, oxmysql).
• Script error: attempt to index a nil value — bug dans le script Lua. Lisez le numéro de ligne, ouvrez le fichier, investiguez.
• oxmysql: no connection — vos identifiants MariaDB/MySQL dans server.cfg sont incorrects ou la base de données ne tourne pas.

Administration des joueurs

L'onglet Players affiche tous les joueurs connectes, ainsi qu'une base de données 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 matériel, Steam, Discord et Xbox Live du joueur. Un joueur banni ne peut pas revenir simplement en changeant d'IP ou de compte Steam — à moins de spoofer l'integralite de son identifiant matériel.

Pour une efficacité maximale, appliquez les bans via txAdmin (et non via des commandes de chat en jeu) afin qu'ils soient persistes dans la base de données de txAdmin.

Redémarrages automatiques et sauvegardes

Deux fonctionnalités que tout serveur doit activer : les redémarrages planifies et les sauvegardes automatiques.

Redémarrages planifies

Les serveurs FiveM accumulent lentement de la mémoire au fil du temps. Un redémarrage propre toutes les 6 à 12 heures maintient des performances stables.

Dans Settings — Restarter :

• Activez "Scheduled Restarts"


• Définissez les horaires de redémarrage (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 redémarrage

Sauvegardes automatiques

txAdmin peut sauvegarder votre dossier server-data + base de données MariaDB selon un planning.

Dans Settings — Backup :

• Activez "Auto Backup"


• Définissez la fréquence (quotidienne recommandée)


• Définissez la rétention (conservez 7 à 14 jours de sauvegardes)


• Specifiez la destination des sauvegardes (dossier local ou stockage compatible S3)

Permissions et rôles admin

txAdmin utilise un système de permissions base sur les rôles. Les rôles par défaut :

• Owner — accès complet à tout (le premier admin)
• Admin — peut gérer les joueurs, redémarrer les ressources, éditer server.cfg
• Moderator — peut kick/ban les joueurs, consulter les logs, mais ne peut pas modifier la configuration du serveur
• Rôles personnalises — vous pouvez définir 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 rôle


4. Ils recevront un lien d'invitation pour définir leur mot de passe

Discord OAuth (recommande)

Lier les comptes admin à Discord OAuth est plus sécurisé que les mots de passe :

• Pas de mot de passe à compromettre


• Revocation plus simple (il suffit de retirer l'accès Discord)


• Meilleure tracabilite (noms d'utilisateur Discord dans les logs)

Résolution des problèmes courants

Le serveur ne démarre pas

• 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 — vérifiez dans la console la dernière ressource chargée

Impossible de se connecter au panneau web txAdmin

• Le pare-feu bloque le port 40120
• txAdmin ne tourne pas (serveur non démarre)
• Mauvaise IP

Les joueurs ne peuvent pas se connecter

• Une ressource n'a pas réussi à se charger — vérifiez la console pour [ERROR]
• Le serveur est plein — vérifiez sv_maxClients
• Le GTA V du joueur n'est pas à jour — demandez-lui de mettre à jour

Erreurs de connexion MariaDB

• Chaîne de connexion incorrecte dans server.cfg
• Le serveur MariaDB ne tourne pas
• Mauvaises permissions utilisateur

Et ensuite ?

Maintenant que vous maîtrisez txAdmin de À à Z :

1. Choisissez votre framework judicieusement — Comparatif ESX vs QBCore vs QBox
2. Sélectionnez vos premiers scripts — Premiers scripts à installer sur votre serveur FiveM
3. 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 spécifiques.