Déployer un serveur FiveM en 1 commande avec txAdmin Recipes

Déployer un serveur FiveM en 1 commande avec txAdmin Recipes

txAdmin recipes : déployer un serveur FiveM complet (framework, BDD, ressources) en quelques minutes via une recette YAML. Guide pas à pas sur Wisp chez VeryCloud.

Introduction

txAdmin est le panel d'administration de référence FiveM. Sa fonctionnalité recipes permet de cloner et configurer un serveur complet (ESX, QBCore, ou custom) en une seule action. Plus besoin de chercher chaque ressource, installer chaque dépendance, configurer chaque fichier : tout est scripté.

Prérequis

  • Un serveur FiveM chez VeryCloud (panel Wisp)
  • txAdmin déjà installé et accessible (port 40120 par défaut)
  • Une BDD MySQL accessible (locale ou externe)
  • URL d'une recipe (officielle ou perso)

Étape 1 : Comprendre une recipe

Une recipe est un fichier YAML qui décrit :

  • Les fichiers à télécharger (git clone, http download)
  • Les ressources à dezipper / placer
  • La BDD à initialiser (SQL imports)
  • La config à générer (server.cfg)

Exemples de recipes populaires :

Recipe URL Framework
QBCore https://github.com/Qbox-project/txAdminRecipe QBox (fork moderne QBCore)
ESX Legacy https://github.com/esx-framework/txAdminRecipe ESX
Standalone (build via txAdmin) Aucun framework

Étape 2 : Accéder à txAdmin

Ton URL txAdmin est http://IP_VERYCLOUD:40120 (ou domaine custom si configuré).

Connecte-toi avec ton compte admin txAdmin.

Étape 3 : Lancer la création de serveur

Dans txAdmin :

  1. Menu → Server
  2. Si pas encore de serveur, New Deployer apparaît
  3. Sélectionne Use a recipe
  4. Colle l'URL de la recipe (ex : https://github.com/Qbox-project/txAdminRecipe)

Étape 4 : Configurer la BDD

txAdmin demande les credentials MySQL :

Host     : ton.mysql.host
Port     : 3306
User     : fivem_user
Password : mdp_solide
Database : fivem_db

txAdmin test la connexion et créera les tables nécessaires à l'install.

💡 Si tu utilises une BDD externe (autre VPS), assure-toi que l'IP du serveur FiveM est whitelistée dans les GRANT MySQL.

Étape 5 : Configurer la licence

Renseigne ton Cfx.re license key (voir tuto dédié). Format : cfxk_xxxxx....

Sans clé valide, txAdmin refuse le deploy.

Étape 6 : Lancer le deploy

Clique Run Recipe. txAdmin va :

  1. Cloner les repos Git listés
  2. Télécharger les ressources externes
  3. Importer les .sql dans la BDD
  4. Générer server.cfg avec les bonnes ensure lines
  5. Build le serveur prêt à démarrer

Comptez 3-10 minutes selon la taille de la recipe et la bande passante.

Étape 7 : Premier démarrage

Une fois le deploy terminé :

  1. txAdmin propose Start Server
  2. Surveille les logs pour les erreurs
  3. Connecte-toi en jeu : F8 puis connect IP_VERYCLOUD

Étape 8 : Créer ta propre recipe

Tu peux écrire ta recipe pour reproduire ton serveur sur d'autres instances. Structure de base (recipe.yaml) :

$onesync: on
$minFxVersion: 7290
$engineVersion: 2802

tasks:
  - action: download_github
    src: https://github.com/qbcore-framework/qb-core
    dest: ./resources/[qb]/qb-core

  - action: download_file
    url: https://example.com/myaddon.zip
    path: ./tmp/myaddon.zip

  - action: unzip
    src: ./tmp/myaddon.zip
    dest: ./resources/myaddon

  - action: connect_database

  - action: query_database
    file: ./resources/[qb]/qb-core/qb-core.sql

  - action: write_file
    file: server.cfg
    data: |
      sv_licenseKey {{cfxLicense}}
      sv_hostname "Mon serveur QBCore"
      ensure qb-core
      ensure oxmysql
      # ... etc

variables:
  - name: cfxLicense
    type: string
    prompt: "Cfx.re license key"

Push sur GitHub, partage l'URL : n'importe qui peut deployer la même base.

Étape 9 : Mettre à jour après deploy

Une fois deployed, ne lance pas une seconde recipe sur le même serveur (ça écraserait). Pour mettre à jour, fais des git pull manuels dans les dossiers des ressources, ou utilise le txAdmin Updater pour les ressources qui le supportent.

Étape 10 : Backup post-deploy

Première chose après un deploy réussi : backup via Wisp Schedules. Tu veux pouvoir revenir à l'état "frais" si une modif casse tout.

Dépannage

Recipe URL invalide

  • Doit pointer vers un repo GitHub avec un recipe.yaml à la racine
  • Test : curl https://raw.githubusercontent.com/user/repo/main/recipe.yaml

Database connection failed

  • Vérifie les credentials
  • IP source autorisée côté MySQL ?
  • Port 3306 ouvert (firewall) ?

Task X failed

  • Lis les logs txAdmin Deployer
  • Souvent un download_github qui pointe vers un repo renommé / supprimé
  • Fork le repo et change l'URL si nécessaire

Le serveur démarre mais crash en boucle

  • Conflit de ressources (deux qui essaient de gérer la BDD)
  • Désactive temporairement chaque ressource pour identifier la coupable

Commandes utiles

# Voir les logs txAdmin
# -> Panel txAdmin / System Logs

# Re-runner une partie d'une recipe (manuel)
cd /resources && git clone <url> <nom>

# Verifier la recipe avant publication
yamllint recipe.yaml

Conclusion

txAdmin recipes = setup serveur FiveM standardisé et reproductible en 10 minutes. Idéal pour reproduire un serveur dev → staging → prod, ou pour donner un kickstart propre à un nouveau projet. Combine avec une CI/CD pour automatiser les mises à jour de tes ressources internes.

Pour aller plus loin : recipes custom pour ton organisation, deploy automatisé via API txAdmin, intégration avec un CI.

Ressources

Join our Discord community server

For any questions, suggestions, or just to chat with the community, join us on Discord!

900+Members