Comment installer txAdmin et créer votre serveur FiveM (tutoriel complet)

Presque tous les serveurs FiveM en activité aujourd’hui ont été créés avec txAdmin — le panneau de contrôle web intégré à la build officielle du serveur. Il gère le déploiement, les redémarrages, les bannissements, la console et votre server.cfg depuis un onglet de navigateur, et il installe une base ESX ou QBCore complète en quelques clics.

Ce tutoriel va d’un dossier vide à un serveur où vos amis peuvent se connecter, en expliquant pourquoi chaque étape compte — pas seulement où cliquer.

Ce qu’il vous faut avant de commencer

• Une machine pour le faire tourner — votre PC pour les tests, ou un hébergement/VPS pour tout ce qui est public.
• Un compte Cfx.re gratuit pour votre clé de licence.
• MySQL ou MariaDB — tout framework sérieux a besoin d’une base de données.
• Environ 45 minutes.

Sous Windows, installez d’abord le Microsoft Visual C++ Redistributable (x64). FXServer ne démarre pas sans, et l’erreur affichée est cryptique — cette seule dépendance manquante explique une grande partie des messages « ça se ferme tout seul ».

Sous Linux, il vous faut xz-utils pour extraire la build, plus un serveur MySQL/MariaDB.

Étape 1 — Obtenir votre clé de licence Cfx.re

Allez sur keymaster.fivem.net, connectez-vous avec votre compte Cfx.re (celui du forum) et enregistrez une nouvelle clé de serveur.

• Choisissez « I’m using a server hosting provider » ou une IP fixe si vous la connaissez — modifiable plus tard.
• Copiez la clé quelque part en sécurité. C’est une longue chaîne aléatoire.

Cette clé identifie votre serveur auprès de Cfx.re. Traitez-la comme un mot de passe : jamais dans une capture Discord, jamais sur GitHub. Une clé fuitée peut être utilisée par quelqu’un d’autre et faire révoquer la vôtre.

Étape 2 — Télécharger les artifacts du serveur

Les artifacts sont la build réelle du serveur (FXServer). Téléchargez-les depuis le runtime officiel :

• Windows — runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux — runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Prenez la build marquée recommended, pas la plus récente tout en haut. Les artifacts de dernière minute cassent régulièrement des ressources, et la build recommandée est celle contre laquelle les développeurs testent réellement. Nous la suivons dans notre guide des artifacts.

Extrayez dans un dossier dédié — par exemple C:\FXServer\server\ sous Windows, ou /home/fivem/server/ sous Linux.

Étape 3 — Organiser vos dossiers

Gardez la build et vos données de serveur dans des dossiers séparés. C’est la meilleure habitude à prendre dès le départ : mettre à jour les artifacts devient « supprimer et remplacer un dossier » plutôt qu’une opération délicate au milieu de vos fichiers.

C:\FXServer\
├── server\          <- les artifacts extraits (remplaçables)
└── server-data\     <- vos ressources, server.cfg, dumps de base

Quand vous mettrez FiveM à jour dans six mois, vous effacez server\, extrayez la nouvelle build, et tout ce qui vous appartient vraiment reste intact.

Étape 4 — Démarrer le serveur pour la première fois

Lancez l’exécutable :

• Windows — double-cliquez sur FXServer.exe dans server\.
• Linux — placez-vous dans le dossier et lancez ./run.sh.

Une console s’ouvre et txAdmin démarre. Vous verrez quelque chose comme :

[txAdmin] Starting txAdmin v7.x.x
[txAdmin] Web UI: http://localhost:40120
[txAdmin] PIN: 4821

Ouvrez cette URL dans un navigateur et saisissez le PIN.

Étape 5 — Créer votre compte maître

txAdmin vous demande de créer le compte maître — l’admin de plus haut niveau qu’aucun autre admin ne peut supprimer.

Utilisez un vrai mot de passe, pas admin123. Ce panneau exécute des commandes console sur votre serveur ; quiconque y accède possède votre communauté. Vous pouvez lier une identité Cfx.re ou Discord pour vous connecter plus facilement.

Perdu plus tard ? Arrêtez le serveur et démarrez-le une fois avec --resetadmin :

FXServer.exe --resetadmin

Étape 6 — Préparer la base de données

Avant de lancer le déployeur, ayez MySQL/MariaDB prêt. Sous Windows, la voie habituelle est XAMPP ou une installation MariaDB autonome ; sous Linux, mariadb-server depuis votre gestionnaire de paquets.

Créez une base vide (par exemple fivem) et un utilisateur avec tous les droits dessus. À l’étape suivante, vous donnerez à txAdmin une chaîne de connexion de cette forme :

mysql://utilisateur:motdepasse@localhost/fivem?charset=utf8mb4

Utilisez un utilisateur dédié, pas root, et donnez-lui un vrai mot de passe. Une base de framework finit par contenir les personnages, l’argent et l’inventaire de chaque joueur — c’est la seule chose que vous ne pourrez vraiment pas reconstruire.

Étape 7 — Déployer un framework avec le déployeur de recettes

Voilà ce qui rend txAdmin indispensable. La page de setup propose plusieurs types de déploiement ; choisissez recettes populaires, puis votre base :

• ESX — le plus grand écosystème ; le plus simple pour trouver scripts, tutoriels et staff qui le connaît.
• QBCore — moderne et orienté roleplay.
• Qbox — une continuation de QBCore axée sur les performances.

Indécis ? Lisez notre comparatif ESX vs QBCore vs Qbox avant de vous engager — migrer plus tard, c’est du vrai travail.

txAdmin vous demande ensuite :

1. Un nom de serveur et le dossier de données (server-data\).
2. Votre chaîne de connexion de l’étape 6.
3. Votre clé de licence de l’étape 1.

Lancez le déploiement. txAdmin télécharge le framework, importe le SQL, écrit un server.cfg fonctionnel et démarre le serveur. Surveillez le log : il vous dit exactement quelle pièce a échoué le cas échéant.

Étape 8 — Vérifier votre server.cfg

La recette écrit une configuration fonctionnelle, mais vous devez comprendre ce qu’elle contient. txAdmin embarque un éditeur (Settings → CFG Editor), donc pas besoin de toucher aux fichiers par FTP pour de petites modifications.

Les lignes qui comptent le plus :

sv_hostname "Mon serveur roleplay"
sv_maxclients 48
sv_licenseKey "votre-cle-ici"

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# OneSync — nécessaire au-delà de 32 joueurs
set onesync on
sv_enforceGameBuild 3095

Deux choses qu’on apprend à la dure :

• sv_maxclients n’est pas une stratégie de croissance. Commencez à 32–48. Un serveur vide de 128 slots a l’air mort ; un serveur plein de 48 a l’air vivant.
• sv_enforceGameBuild fixe la build GTA attendue par votre serveur. Ne la changez que si une ressource a vraiment besoin de contenu DLC récent, et prévoyez de tout retester ensuite.

Étape 9 — Ouvrir les bons ports

Les joueurs se connectent sur le 30120, TCP et UDP. Si vous ne redirigez que le TCP, le serveur apparaît dans la liste mais personne ne peut entrer — le classique qui coûte un après-midi.

N’exposez jamais le 40120 publiquement. Si vous avez besoin d’un accès distant, mettez-le derrière un VPN ou un reverse proxy avec HTTPS et un mot de passe solide. Un panneau txAdmin ouvert sur Internet est une console distante complète de votre serveur, et des bots scannent pour ça.

Étape 10 — Apprendre le panneau

Consacrez-lui dix minutes ; c’est rentabilisé :

• Dashboard — graphique de performances en direct. Quand les joueurs disent « ça lag », c’est ici que vous confirmez.
• Live Console — la vraie console du serveur dans votre navigateur. Lisez de haut en bas et corrigez toujours la première erreur rouge ; le reste n’est souvent que la cascade.
• Players — rechercher, avertir, expulser, bannir, et voir l’historique par identifiant.
• Restarter — redémarrages programmés. Configurez-les dès le premier jour (voir ci-dessous).
• CFG Editor — éditer server.cfg sans FTP.
• Bot Discord — optionnel ; messages de statut et whitelist par rôles.

Configurez les redémarrages programmés tout de suite

Dans Settings → Restarter, programmez un redémarrage toutes les 6 à 12 heures. Un FXServer qui tourne longtemps accumule de la mémoire et se dégrade lentement ; un redémarrage programmé avec compte à rebours est invisible pour les joueurs. Un crash imprévu en heure de pointe ne l’est pas.

Étape 11 — Ajouter vos premières ressources

Avec un framework en place, les ressources vont dans server-data/resources/, chacune activée par une ligne ensure. L’ordre compte — les dépendances démarrent en premier :

# Cœur — d'abord ceux-là
ensure oxmysql
ensure ox_lib
ensure es_extended

# Gameplay
ensure mon-inventaire
ensure mon-hud

Ajoutez les ressources une par une, en redémarrant entre chaque. Si vous déposez quinze scripts d’un coup et que le serveur meurt, vous avez quinze suspects. Une par une, vous savez toujours exactement ce qui a cassé.

Les systèmes que les joueurs remarquent en premier sont l’inventaire et le HUD — ils sont à l’écran en permanence, donc ils définissent le ressenti de votre serveur plus que n’importe quel script de métier. Notre guide des meilleurs inventaires FiveM compare le terrain ; si vous en voulez un qui couvre ESX, QB, QBCore et Qbox depuis une seule base de code, Quasar Inventory est le polyvalent soigné sur lequel nous revenons systématiquement en test. Pour l’installation pas à pas, suivez notre tutoriel d’installation d’inventaire.

Étape 12 — Tester sérieusement, puis ouvrir

Connectez-vous en local avec connect localhost depuis le client FiveM (console F8), puis faites entrer un ami via votre adresse publique.

Parcourez la boucle complète avant d’annoncer quoi que ce soit : apparaître, prendre un métier, gagner de l’argent, ouvrir l’inventaire, ranger un objet, acheter et sortir une voiture, se reconnecter et vérifier que tout a persisté. La reconnexion est le vrai test — la plupart des « mon serveur perd les données des joueurs » sont un problème de base de données qui n’apparaît qu’à la reconnexion.

Sauvegardez votre base — txAdmin ne le fera pas

C’est la faille la plus courante sur des serveurs par ailleurs bien tenus. txAdmin gère votre serveur ; il ne sauvegarde pas votre base de données. Mettez en place votre propre dump programmé :

mysqldump -u fivem -p fivem > backup-$(date +%F).sql

Automatisez-le (cron ou Planificateur de tâches) et gardez des copies hors de la machine. Un serveur qu’on reconstruit en un après-midi est un désagrément. Une base qu’on ne peut pas restaurer, c’est la fin de la communauté.

Dépannage

Et ensuite

Vous avez maintenant un serveur qui tourne, redémarre et est sauvegardé. Les deux choses qui décident si les joueurs restent sont les performances et une boucle de jeu cohérente — pas le nombre de scripts.

Lisez notre guide d’optimisation avant votre première soirée chargée, et comment réduire le lag quand il arrivera, car il arrivera. Ensuite, fermez les portes : notre guide de sécurité couvre ce qu’il faut durcir avant que vous ne valiez la peine d’être attaqué.