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 :
- Menu → Server
- Si pas encore de serveur, New Deployer apparaît
- Sélectionne Use a recipe
- 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 :
- Cloner les repos Git listés
- Télécharger les ressources externes
- Importer les .sql dans la BDD
- Générer
server.cfgavec les bonnesensurelines - 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é :
- txAdmin propose Start Server
- Surveille les logs pour les erreurs
- Connecte-toi en jeu :
F8puisconnect 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_githubqui 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.


















