Vous voulez installer ESX sur votre serveur FiveM en 2026 ? Bonne nouvelle : avec ESX Legacy et txAdmin, le processus a été considérablement simplifié ces dernières années. Mais il reste des étapes techniques incontournables — base de données MySQL, configuration d’oxmysql, ordre de chargement des ressources — que beaucoup de guides bâclent.
Ce guide vous explique tout dans le bon ordre, avec les vraies commandes et les vraies valeurs de configuration. Suivez les étapes et votre serveur FiveM avec ESX sera opérationnel en moins d’une heure.
Qu'est-ce qu'ESX et pourquoi l'utiliser ?
ESX (EssentialMode Extended) est le framework RP le plus utilisé sur FiveM. Il ajoute sur votre serveur un système complet d’économie, de jobs, d’inventaire, de comptes bancaires et de gestion des personnages. Sans ESX, votre serveur FiveM est une map GTA multijoueur basique. Avec ESX, c’est un véritable univers RP persistant.
ESX Legacy | ESX 1.2 (ancien) | |
Statut | Maintenu activement | Maintenu mais en fin de vie |
Connecteur MySQL | oxmysql (moderne) | mysql-async (ancien) |
Compatibilité scripts | Scripts modernes (2023-2026) | Scripts anciens |
Performances | Meilleures (async optimisé) | Correctes |
Recommandé pour | Tout nouveau serveur en 2026 | Migration anciens serveurs uniquement |
La règle en 2026 : utilisez toujours ESX Legacy pour un nouveau serveur. ESX 1.2 ne reçoit plus de mises à jour majeures et sa compatibilité avec les nouveaux scripts est limitée.
Ce qu'il vous faut avant de commencer
Avant de démarrer l’installation, assurez-vous d’avoir ces éléments en place :
- Un serveur FiveM opérationnel : hébergé chez Portallis ou autre, avec txAdmin préconfiguré et une clé Keymaster valide
- Une base de données MySQL : chez Portallis, une base MySQL est incluse dans votre plan — vérifiez vos identifiants dans votre panel
- Un accès aux fichiers : gestionnaire de fichiers dans votre panel ou accès FTP — vous en aurez besoin pour uploader les ressources
- HeidiSQL ou phpMyAdmin : pour importer les fichiers SQL d’ESX dans votre base de données
⚠️ RAM minimum pour ESX ESX Legacy avec quelques scripts de base nécessite minimum 4 Go de RAM. Avec 15-20 scripts actifs (jobs, inventaire, véhicules), prévoyez 6-8 Go. En dessous de 4 Go, votre serveur sera instable dès les premières connexions. |
Installer ESX FiveM : étape 1 — télécharger ESX Legacy
Rendez-vous sur le dépôt officiel ESX Legacy : github.com/esx-framework/esx-legacy.
- Cliquez sur le bouton vert « Code » → « Download ZIP »
- Décompressez l’archive — vous obtenez plusieurs dossiers : [core], [default], [jobs], [addons]
- Ne modifiez aucun fichier avant d’avoir terminé l’installation complète
Structure des dossiers ESX Legacy :
[core] → es_extended, oxmysql, ox_lib — le cœur d’ESX, à charger en premier
[default] → esx_skin, esx_identity, esx_basicneeds — ressources de base
[jobs] → esx_policejob, esx_ambulancejob — les jobs inclus par défaut
[addons] → ressources optionnelles
Important : uploadez tous ces dossiers dans le répertoire resources/ de votre serveur FiveM en conservant exactement la structure de dossiers. Ne déplacez pas les fichiers entre les sous-dossiers.
Étape 2 — Installer et configurer oxmysql
oxmysql est le connecteur MySQL utilisé par ESX Legacy. Il remplace l’ancien mysql-async. Sans oxmysql correctement configuré, ESX ne démarrera pas
Télécharger oxmysql
Téléchargez la dernière version depuis github.com/overextended/oxmysql. Placez le dossier oxmysql dans resources/[core]/.
Créer la base de données ESX
Connectez-vous à votre base de données via HeidiSQL ou phpMyAdmin avec les identifiants fournis dans votre panel Portallis. Créez une nouvelle base de données :
Nom : es_extended
Encodage : utf8mb4_unicode_ci
Importez ensuite le fichier SQL fourni avec ESX Legacy — il se trouve dans le dossier [core]/es_extended/. Ce fichier crée toutes les tables nécessaires (users, jobs, items, vehicles, etc.).
Configurer la connexion dans server.cfg
Ajoutez la ligne suivante dans votre server.cfg en remplaçant les valeurs par vos identifiants MySQL :
set mysql_connection_string « mysql://UTILISATEUR:MOTDEPASSE@localhost/es_extended?charset=utf8mb4 »
⚠️ Trouver vos identifiants MySQL chez Portallis Vos identifiants MySQL se trouvent dans votre panel Portallis → onglet Bases de données. Le host est généralement ‘localhost’ ou ‘127.0.0.1’. Si vous ne voyez pas de base de données, créez-en une depuis le panel avant de continuer. |
Étape 3 — Configurer le server.cfg pour ESX
L’ordre de chargement des ressources dans le server.cfg est critique. Une ressource chargée avant ses dépendances provoque des erreurs au démarrage.
Voici l’ordre recommandé pour ESX Legacy :
# ── Connecteur MySQL ──────────────────
ensure oxmysql
# ── Librairie ox ──────────────────────
ensure ox_lib
# ── Cœur ESX ──────────────────────────
ensure es_extended
# ── Ressources de base ESX ────────────
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
ensure esx_context
# ── Personnalisation personnage ────────
ensure esx_skin
ensure esx_identity
# ── Besoins de base ───────────────────
ensure esx_basicneeds
# ── Jobs ──────────────────────────────
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
Règle absolue : oxmysql → ox_lib → es_extended → tout le reste. Ne jamais inverser cet ordre.
Étape 4 — Utiliser txAdmin pour simplifier l'installation
Si vous utilisez txAdmin (inclus chez Portallis), vous avez accès aux recettes d’installation automatique. Pour ESX Legacy, une recette officielle est disponible directement depuis l’interface txAdmin.
- Connectez-vous à votre panel txAdmin (port 40120 par défaut)
- Allez dans « Déployer une recette »
- Sélectionnez « ESX Legacy » dans la liste des recettes officielles
- Renseignez vos identifiants MySQL quand demandé
- Lancez le déploiement — txAdmin télécharge et configure tout automatiquement
Avantage de la recette txAdmin : elle installe ESX Legacy avec les bonnes versions d’oxmysql et ox_lib, dans le bon ordre, avec la base de données préconfigurée. C’est la méthode la plus simple pour un premier serveur.
Lancer mon serveur FIVEM sur Portallis
Plans RAM dès 4 Go à 4€/mois — Ryzen 7 9700X — txAdmin inclus — Support humain
Étape 5 — Vérifier que l'installation fonctionne
Une fois le serveur démarré, vérifiez les points suivants :
Dans les logs serveur
Regardez les premières lignes de logs au démarrage. Vous devez voir :
- [oxmysql] — pas d’erreur de connexion MySQL
- [es_extended] — « ESX started successfully »
- Absence de « script attempted to stop a readonly resource »
Si vous voyez des erreurs, les causes les plus fréquentes sont : mauvaise chaîne de connexion MySQL, base de données non créée, ou ordre de chargement incorrect dans le server.cfg.
En jeu
Connectez-vous à votre serveur. Vous devez voir :
- Un menu de création de personnage au premier lancement
- Un inventaire de base accessible
- L’interface ESX en bas à gauche (argent, job, etc.)
⚠️ Erreur fréquente : ‘es_extended is not started’ Cette erreur signifie qu’un script essaie de charger avant es_extended. Vérifiez l’ordre de vos ‘ensure’ dans server.cfg — es_extended doit être chargé avant tous vos scripts ESX. |
Les premiers scripts ESX à installer après l'installation
ESX seul ne fait pas grand chose — c’est en ajoutant des scripts que votre serveur prend vie. Voici les scripts à installer en priorité, dans l’ordre :
Script | Rôle | Pourquoi en premier |
esx_society | Gestion des sociétés/banques job | Requis par presque tous les jobs |
esx_inventoryhud | Interface inventaire visuelle | Remplace l’inventaire basique |
esx_vehicleshop | Concessionnaire auto | Économie de base |
esx_garage | Garage et gestion des véhicules | Nécessaire avec vehicleshop |
esx_addonaccount | Comptes bancaires étendus | Requis par esx_society |
esx_billing | Amendes et factures | Utilisé par police et ambulance |
Comment ajouter un script ESX :
- Téléchargez le script (GitHub ou forum Cfx.re officiel uniquement — évitez les sources inconnues)
- Placez-le dans resources/[esx]/ pour garder votre arborescence propre
- Ajoutez ensure nomduScript dans votre server.cfg, après es_extended
- Importez le fichier .sql du script dans votre base de données si nécessaire
- Redémarrez le serveur et vérifiez les logs
Règle d’or : installez les scripts un par un. Si vous en ajoutez dix d’un coup et que quelque chose ne fonctionne pas, vous ne saurez pas lequel est responsable.
Après avoir installé ESX FiveM : les erreurs les plus fréquentes
« MySQL connection failed »
Vérifiez votre chaîne de connexion MySQL dans server.cfg — un espace, un caractère spécial mal encodé ou un mauvais nom de base de données suffit à bloquer la connexion. Testez aussi la connexion directement depuis HeidiSQL avec les mêmes identifiants.
Le personnage ne se sauvegarde pas
Ce problème vient généralement d’un problème d’import SQL incomplet. Retournez dans HeidiSQL et vérifiez que la table users existe dans votre base es_extended et qu’elle contient toutes ses colonnes.
Scripts ESX qui ne fonctionnent pas
Vérifiez que vous avez bien importé le fichier .sql du script ET ajouté l’ensure dans le bon ordre dans server.cfg. Vérifiez aussi que la version du script est compatible avec ESX Legacy — certains anciens scripts ne sont compatibles qu’avec ESX 1.2.
Erreur « oxmysql » au démarrage
Vérifiez que la version d’oxmysql est compatible avec votre version d’ESX Legacy. Téléchargez toujours la dernière version d’oxmysql depuis son dépôt GitHub officiel.
FAQ — Questions fréquentes sur l'installation d'ESX FiveM
Quelle est la différence entre ESX Legacy et ESX 1.2 ?
ESX Legacy est la version moderne et maintenue activement — elle utilise oxmysql pour les connexions MySQL et est compatible avec les scripts récents. ESX 1.2 est l’ancienne version qui utilise mysql-async. Pour tout nouveau serveur en 2026, utilisez ESX Legacy.
Peut-on installer ESX sans base de données MySQL ?
Non. ESX nécessite une base de données MySQL pour fonctionner — elle stocke les personnages des joueurs, leurs inventaires, leurs jobs et leur argent. Sans MySQL, ESX ne démarrera pas. Chez Portallis, une base MySQL est incluse dans votre plan.
ESX est-il compatible avec QBCore ?
Non — ESX et QBCore sont deux frameworks distincts et incompatibles entre eux. Les scripts ESX ne fonctionnent pas avec QBCore et inversement. Choisissez un seul framework pour votre serveur.
Combien de RAM faut-il pour un serveur FiveM avec ESX ?
Minimum 4 Go de RAM pour ESX Legacy avec quelques scripts de base. Pour une communauté publique avec 20 scripts ou plus, prévoyez 6 à 8 Go. Sous 4 Go, votre serveur sera instable dès que plusieurs joueurs se connectent.
Comment mettre à jour ESX Legacy sans perdre mes données ?
Faites une sauvegarde de votre base de données MySQL AVANT toute mise à jour. Téléchargez la nouvelle version d’ESX Legacy depuis GitHub, remplacez les dossiers [core] et [default] par les nouveaux, et vérifiez le changelog pour savoir si de nouvelles migrations SQL sont nécessaires. Ne remplacez jamais vos scripts personnalisés sans vérifier leur compatibilité avec la nouvelle version.
Conclusion
Vous savez maintenant comment installer ESX sur votre serveur FiveM correctement en 2026 : télécharger ESX Legacy depuis GitHub, configurer oxmysql avec votre base MySQL, respecter l’ordre de chargement dans server.cfg, et ajouter vos premiers scripts progressivement.
Si vous n’avez pas encore de serveur FiveM, Portallis propose des plans dès 4 Go à 4€/mois avec MySQL inclus, txAdmin préconfiguré, et un support francophone disponible pour vous accompagner dans l’installation d’ESX.
- À lire aussi : Créer un serveur FiveM en 2026 — guide complet
- À lire aussi : Meilleur hébergeur FiveM 2026
- Ressource officielle : Dépôt ESX Legacy sur GitHub