Comment configurer txAdmin sur votre serveur FiveM

Votre serveur se déploie avec txAdmin en marche et le serveur de jeu volontairement retenu. Cinq étapes dans l'assistant le mettent en ligne, et l'une d'elles, la connexion à la base, est l'endroit où presque tout le monde s'arrête, car ses champs sont cachés derrière un bouton. Le bouton et les valeurs figurent sur cette page.

D'abord : un serveur hors ligne est normal ici

Un déploiement FiveM neuf démarre txAdmin et rien d'autre. Le port de jeu reste volontairement silencieux tant que vous n'avez pas revendiqué le compte administrateur, fourni une clé de licence et choisi une version du serveur, car un serveur FiveM sans ces éléments ne peut pas démarrer. Donc pendant les premières minutes après le déploiement, le tableau de bord qui indique que le serveur n'accepte pas encore de joueurs est l'état attendu et non une panne.

Le tableau de bord l'indique : la carte du serveur passe en orange avec Action requise : terminez la configuration dans txAdmin, et l'ouvrir vous donne le lien txAdmin et le PIN décrit plus bas. Rien sur cette page ne nécessite un ticket de support.

Les cinq étapes

1. Ouvrez txAdmin

Vous n'avez pas besoin de chercher une adresse. Dans votre tableau de bord, la bannière orange de la carte du serveur ouvre un panneau avec un bouton Ouvrir txAdmin, et le même bouton se trouve dans l'onglet Joueurs une fois que vous cliquez sur Gérer. Il pointe vers le domaine txAdmin propre à votre serveur, qui continue de fonctionner après un basculement car il se résout toujours vers l'instance actuellement principale. C'est pour cela que nous fournissons un lien plutôt qu'une IP de nœud : une IP est correcte jusqu'au jour où elle ne l'est plus.

2. Revendiquez le compte administrateur avec le PIN

Au premier lancement, txAdmin demande un PIN qu'il n'affiche que dans la console du serveur, puis vous demande de créer un identifiant et un mot de passe administrateur principal pour le panneau lui-même. Sur un serveur géré, cette console n'est normalement pas accessible, donc le tableau de bord lit le PIN dans le journal du conteneur et l'affiche dans le même panneau que le bouton txAdmin, prêt à être copié.

L'identifiant administrateur principal n'est ni votre compte Flux, ni votre compte Cfx.re, ni le mot de passe de la base. C'est un troisième identifiant, c'est le moyen de revenir dans votre panneau, et personne ne peut le réinitialiser à votre place. Notez-le avant de continuer. Si le PIN a expiré au moment de l'utiliser, redémarrez le serveur depuis le tableau de bord et un nouveau PIN s'affiche.

3. Choisissez une version du serveur

L'assistant propose ensuite une recette ou un serveur existant. Une recette comme qbcore, qbox ou ESX télécharge le framework, ses ressources et son schéma SQL, puis importe le schéma dans votre base, ce qui est le chemin le plus rapide vers un serveur de roleplay fonctionnel. Choisissez-en une et txAdmin l'affiche sur un écran appelé Étape 1 : vérifier la recette. Continuez, et vous arrivez à Étape 2 : paramètres d'entrée, où se déroulent les deux étapes suivantes.

4. Ajoutez votre clé de licence cfx.re

Le premier champ des Paramètres d'entrée est Clé d'enregistrement du serveur. Générez-en une gratuitement sur portal.cfx.re et collez la valeur cfxk_. La clé est émise pour votre compte et non pour le nôtre, ce qui fait que le serveur vous appartient et peut être déplacé ; le déploiement définit NO_LICENSE_KEY=1 afin que la clé soit fournie ici plutôt qu'intégrée à l'application. Si vous régénérez la clé un jour, vous pouvez la changer plus tard sans refaire l'assistant : c'est un champ de l'onglet Paramètres du serveur dans le panneau de gestion.

5. Ouvrez les options de base de données et connectez la base

C'est l'étape qui génère le plus de tickets de support, car les champs de base sont cachés. Juste sous la clé, il y a un bouton gris, Afficher/Masquer les options de base de données (avancé). Cliquez dessus. C'est seulement à ce moment-là qu'apparaissent les champs Hôte, Port, Nom d'utilisateur, Mot de passe et Nom de la base. Si vous sautez ce bouton, la recette s'exécute avec les valeurs par défaut de txAdmin et la connexion à la base échoue.

Les champs sont pré-remplis, avec localhost comme hôte et 3306 comme port. Ces valeurs par défaut sont incorrectes sur ce serveur. Remplacez le contenu de chaque champ par ces valeurs :

L'hôte est l'opérateur de synchronisation et non le conteneur de la base, le mot de passe est celui que vous avez choisi au déploiement, et la base elle-même est créée vide pour vous avant le démarrage du serveur.

Le mot de passe se trouve dans le panneau de gestion sous Paramètres de déploiement, sous le nom MYSQL_ROOT_PASSWORD, avec un bouton d'affichage et un bouton de copie. Le panneau affiche aussi ces quatre valeurs fixes sur une carte à côté, pour que vous puissiez les copier directement dans txAdmin sans revenir ici.

Deux suppositions méritent d'être nommées, car elles sont fausses et semblent justes toutes les deux. L'hôte n'est pas localhost : txAdmin et la base sont deux conteneurs distincts. L'hôte n'est pas non plus mariadb, même s'il existe un composant portant ce nom. Tout passe par l'opérateur, qui réplique chaque écriture vers les autres instances ; écrire directement dans un seul MariaDB désynchroniserait votre ville et la ferait perdre lors d'un basculement.

Lancez ensuite la recette. txAdmin télécharge l'artifact FiveM, importe le schéma, écrit server.cfg et démarre le serveur, et votre tableau de bord passe au vert en quelques minutes. Si vous avez choisi un serveur existant au lieu d'une recette, il n'y a pas de champs de base à remplir : réglez la connexion dans votre server.cfg, comme indiqué dans les questions ci-dessous.

Si txAdmin indique qu'il ne peut pas se connecter

Vérifiez d'abord l'hôte et le port, car localhost et mariadb sont les suppositions courantes, et aucune des deux ne fonctionne. Si ces valeurs sont correctes, c'est un mot de passe qui ne correspond pas. La base est provisionnée avec MYSQL_ROOT_PASSWORD et l'opérateur s'authentifie avec DB_INIT_PASS, et les deux doivent être identiques pour que la base s'initialise. Le panneau les relie justement pour cette raison : modifier l'une réécrit l'autre, et le champ est marqué comme lié pour que ce comportement ne ressemble pas à un formulaire qui refuse votre saisie. Ce que vous tapez dans txAdmin doit être cette même valeur.

Revenir plus tard

Une fois l'assistant terminé, txAdmin devient le panneau du quotidien : console en direct, ressources, bannissements, éditeur CFG et redémarrages planifiés. Le même bouton Ouvrir txAdmin vous y mène, et vous vous connectez avec le compte administrateur principal de l'étape 2. Le tableau de bord gère la couche en dessous : redémarrages et redéploiements, gestionnaire de fichiers, matériel, santé de la base sur tous les nœuds et sauvegardes.

Questions fréquentes