Offre Durée limitée : -10% sur tout le site* avec le code ELYPSEWELCOME10

Lier une base de données MySQL ou MariaDB à son serveur FiveM

Mis à jour le 5 novembre 2026 12 min de lecture 11 sections

Un serveur FiveM sans base de données ne retient rien : à la déconnexion, les joueurs, l'argent, les véhicules et l'inventaire disparaissent. Les frameworks ESX Legacy, QBCore et Qbox s'appuient sur une base de données MySQL ou MariaDB, interrogée par la ressource oxmysql, pour stocker toute la progression. Relier cette base au serveur est donc l'une des premières opérations à faire après l'installation de FXServer.

Ce guide s'adresse à ceux qui administrent un serveur FiveM, pas aux simples joueurs. Il couvre les deux situations que nous rencontrons en support : une base créée dans le panel d'un hébergeur FiveM infogéré, et une base MariaDB que vous installez vous-même en ligne de commande sur un VPS Linux ou un serveur dédié sous Ubuntu ou Debian. Dans les deux cas, la chaîne de connexion à écrire dans server.cfg est la même.

Pourquoi un serveur FiveM a besoin d'une base MySQL

Les scripts FiveM ne lisent pas la base directement. Ils passent par oxmysql, une ressource qui ouvre les connexions vers le serveur de base de données et exécute les requêtes SQL envoyées par le framework et par chaque script (inventaire, garage, banque, jobs). oxmysql embarque le pilote Node.js mysql2 : il ne parle que le protocole MySQL. Concrètement :

  • MariaDB et MySQL fonctionnent tous les deux. La documentation d'oxmysql recommande MariaDB pour la compatibilité et les performances, et signale que la plupart des ressources FiveM ont été écrites pour MySQL 5.7 : sur MySQL 8, des mots-clés réservés et des valeurs par défaut sur les colonnes JSON ou longtext peuvent faire échouer l'import des scripts.
  • PostgreSQL, SQL Server et SQLite ne sont pas utilisables avec oxmysql, donc pas davantage avec ESX ou QBCore. Si un hébergeur ne propose que PostgreSQL, il faudra une base MySQL ailleurs.
  • Le vocabulaire : une base de données (BDD, database dans la chaîne de connexion) regroupe des tables ; une requête est une lecture ou une écriture SQL ; une connexion est le canal TCP ouvert entre oxmysql et MariaDB, par défaut sur le port 3306.

Où héberger la base : panel, VPS ou hébergement web

Avant de copier une chaîne de connexion, il faut savoir où tourne le moteur MariaDB et qui l'administre. Trois cas se présentent, avec des conséquences très différentes en exploitation.

ScénarioQui administre MariaDBAccèsBackupAdapté à FiveM ?
Panel d'un hébergeur FiveM (infogérance) L'hébergeur installe, met à jour et surveille le moteur ; vous créez vos bases dans le panel phpMyAdmin et identifiants fournis par le panel Sauvegardes du panel, plus un export SQL de votre côté Oui, le cas le plus simple
VPS Linux ou serveur dédié que vous administrez Vous, en SSH avec un compte root ou sudo, sur Ubuntu ou Debian Ligne de commande, utilisateur MariaDB dédié, pare-feu à votre charge Script mariadb-dump planifié par cron, copie hors site Oui, avec le plus de contrôle sur la RAM, le CPU et la configuration
Hébergement web mutualisé (Plesk, site vitrine, CMS) L'hébergeur, pour servir des sites web PHP derrière Apache ou nginx Accès distant à MySQL fermé ou limité selon les offres Sauvegardes orientées site web Non : chaque requête traverse Internet et l'accès distant n'est pas garanti

La base d'un hébergement web est prévue pour un CMS qui tourne sur la même machine que le serveur web. Un serveur FiveM hébergé ailleurs ferait transiter chaque requête d'inventaire ou de garage par Internet, avec une latence qui se répercute sur le tick du serveur. Gardez donc la base à côté de FXServer : dans le panel de votre hébergeur FiveM, ou sur le VPS qui fait tourner le serveur.

Scénario 1 : créer la base dans le panel de l'hébergeur

Chez un hébergeur FiveM, le moteur MySQL ou MariaDB est déjà installé et administré pour vous. Les offres serveur FiveM ElypseCloud incluent trois bases SQL par serveur, txAdmin et la protection anti-DDoS. La procédure :

  1. Connectez-vous à votre espace client ElypseCloud.
  2. Ouvrez le panel de votre serveur FiveM et accédez à la section Bases de données.
  3. Créez une nouvelle base et notez les quatre informations affichées : l'hôte (une adresse IP ou un nom DNS, parfois suivi du port 3306), le nom de la base, le nom d'utilisateur et le mot de passe.

Ces identifiants sont ceux que vous reporterez dans server.cfg. Si le panel propose de régénérer le mot de passe, choisissez-en un long et alphanumérique : la section sur les pièges explique pourquoi.

Scénario 2 : installer MariaDB sur un VPS ou un serveur dédié

Sur un VPS (virtualisation KVM) ou un serveur dédié, vous administrez tout vous-même : le système, le pare-feu, le moteur de base de données et ses sauvegardes. C'est plus de travail, mais vous choisissez la version de MariaDB, la part de RAM qui lui revient et le nombre de connexions autorisées. Connectez-vous en SSH avec un compte sudo plutôt qu'avec root directement (voir sécuriser SSH sur un VPS Linux) et installez le serveur depuis les dépôts Ubuntu ou Debian :

sudo apt update
sudo apt install mariadb-server mariadb-client -y
sudo mariadb-secure-installation

Le script de sécurisation supprime les comptes anonymes, interdit la connexion du compte root MariaDB depuis l'extérieur et retire la base de test. Le détail des options, dépôt officiel compris, est dans notre guide installer MariaDB sur un VPS Linux.

Créez ensuite une base et un utilisateur réservés à FiveM. Le serveur de jeu ne doit jamais se connecter avec root : si un script douteux récupère la chaîne de connexion, il n'accède qu'à cette base.

sudo mariadb
CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'MotDePasseLongEtAlphanumerique';
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Deux cas selon l'endroit où tourne FXServer :

  • FXServer et MariaDB sur la même machine (le cas courant) : l'hôte est localhost ou 127.0.0.1, rien à ouvrir dans le pare-feu, et MariaDB garde sa valeur par défaut bind-address = 127.0.0.1 dans /etc/mysql/mariadb.conf.d/50-server.cnf.
  • FXServer sur un autre serveur : créez l'utilisateur avec l'adresse IP du serveur FiveM à la place de localhost ('fivem'@'203.0.113.50'), remplacez bind-address par l'adresse IP de l'interface qui doit écouter, redémarrez MariaDB avec sudo systemctl restart mariadb, puis n'ouvrez le port 3306 que depuis cette adresse IP : sudo ufw allow from 203.0.113.50 to any port 3306. Le guide ouvrir les ports avec UFW détaille les règles. Un port 3306 ouvert à tout Internet est scanné en permanence.

Pour aller plus loin sur les privilèges (lecture seule pour un site, droits complets pour FiveM), voir créer un utilisateur admin MySQL ou MariaDB.

Importer le fichier .sql du framework

ESX Legacy, QBCore et la plupart des scripts livrent un fichier .sql qui crée leurs tables. Il doit être importé une fois, avant le premier démarrage. Selon le scénario :

  • Depuis le panel : ouvrez phpMyAdmin, sélectionnez votre base, onglet Import, puis choisissez le fichier. phpMyAdmin est une application PHP servie par le serveur web (Apache ou nginx) de l'hébergeur : vous n'avez rien à installer.
  • Depuis un VPS : envoyez le fichier sur le serveur en SFTP (le transfert de fichiers par SSH, préférable au FTP en clair), puis importez-le en ligne de commande avec mariadb -u fivem -p fivem < /chemin/vers/fichier.sql.
  • Avec txAdmin : si vous déployez via une recette, le déployeur demande les identifiants de la base à sa deuxième étape et s'en sert pour les tâches de base de données prévues par la recette. Voir configurer txAdmin sur un serveur FiveM.

Pour migrer une base existante depuis un autre hébergeur, l'export puis l'import sont décrits dans sauvegarder et restaurer la base MySQL d'un serveur FiveM.

Configurer la connexion dans server.cfg

Ouvrez server.cfg (gestionnaire de fichiers du panel, ou éditeur en SSH sur un VPS). La chaîne de connexion se déclare avec set, avant le démarrage des ressources, et oxmysql doit démarrer en tête de la liste des ressources, avant le framework. oxmysql accepte deux formats, au choix :

# Format clé=valeur
set mysql_connection_string "server=127.0.0.1;port=3306;database=fivem;user=fivem;password=MotDePasseLongEtAlphanumerique"

# Format URI, équivalent
set mysql_connection_string "mysql://fivem:MotDePasseLongEtAlphanumerique@127.0.0.1:3306/fivem"

ensure oxmysql
ensure ox_lib
ensure es_extended

Dans le format clé=valeur, oxmysql reconnaît plusieurs alias : server=, host= ou ip= pour l'hôte, user=, userid= ou uid= pour le nom d'utilisateur, pass= ou pwd= pour le mot de passe, db= pour la base. Le port y est une clé séparée (port=3306). Dans le format URI, le port se colle à l'hôte après deux-points. L'hôte peut être une adresse IP ou un nom de domaine résolu par DNS ; sur un VPS où tout tourne sur la même machine, 127.0.0.1 évite une résolution DNS inutile à chaque redémarrage.

Remplacez chaque valeur par celles de votre panel ou de l'utilisateur créé plus haut. Si ox_lib est installé, il se lance juste après oxmysql : notre guide installer ox_lib sur un serveur FiveM montre l'ordre complet.

Les pièges qui cassent la connexion

  • Le port collé à l'hôte dans le format clé=valeur : si le panel affiche hote:3306, écrivez server=hote;port=3306. Avec server=hote:3306, oxmysql cherche une machine nommée hote:3306 et la connexion échoue.
  • Les caractères spéciaux dans le mot de passe : la documentation d'oxmysql recommande d'éviter ; , / ? : @ & = + $ #, réservés dans l'un ou l'autre format (le point-virgule et le signe égal découpent le format clé=valeur, l'arobase et les deux-points découpent l'URI). Un mot de passe long et alphanumérique règle le problème ; sinon, essayez l'autre format.
  • L'utilisateur n'est pas autorisé depuis cet hôte : un compte créé en 'fivem'@'localhost' est refusé quand FXServer se connecte depuis une autre adresse IP. MariaDB répond alors Access denied ou Host ... is not allowed to connect. Recréez l'utilisateur avec la bonne adresse IP.
  • Le port 3306 filtré : sur un VPS, un bind-address resté à 127.0.0.1 ou un pare-feu qui bloque 3306 produit une connexion refusée ou expirée. Testez depuis le serveur FiveM avec mariadb -h ADRESSE_IP -u fivem -p.
  • MySQL 8 au lieu de MariaDB : des scripts dont le SQL date de MySQL 5.7 échouent à l'import à cause de mots-clés réservés ou de valeurs par défaut non supportées. Si vous avez le choix, installez MariaDB.
  • La chaîne déclarée après les ressources : oxmysql lit la convar au démarrage. Placez le set mysql_connection_string avant tout ensure.

Redémarrer, vérifier, diagnostiquer

Redémarrez le serveur FiveM. Dans la console, oxmysql doit annoncer une connexion réussie à la base ; une erreur d'authentification, d'hôte introuvable ou de port s'affiche dès cette étape, avant même que le framework ne charge. Pour aller plus loin, oxmysql propose des convars de diagnostic à ajouter dans server.cfg :

set mysql_slow_query_warning 150
set mysql_debug true

La première affiche un avertissement pour chaque requête qui dépasse le seuil fixé, ici 150 ms (les requêtes lentes au démarrage sont normales). La seconde imprime toutes les requêtes dans la console ; vous pouvez la limiter à une ressource avec la commande oxmysql_debug add ox_inventory pendant que le serveur tourne. Côté base, SHOW PROCESSLIST; dans le client MariaDB liste les connexions ouvertes par oxmysql et ce qu'elles exécutent.

Partager la base avec un site web ou un bot

Beaucoup de serveurs RP exposent leurs données hors du jeu : un site web en PHP qui affiche les statistiques des joueurs, un bot Discord en Python qui consulte les comptes bancaires, un tableau de bord d'administration. Tous ces scripts se connectent à la même base MariaDB, mais pas avec le compte de FiveM. Créez un second utilisateur limité à la lecture, autorisé uniquement depuis l'adresse IP du serveur web ou de la machine qui héberge le bot :

CREATE USER 'site_lecture'@'203.0.113.80' IDENTIFIED BY 'AutreMotDePasseAlphanumerique';
GRANT SELECT ON fivem.* TO 'site_lecture'@'203.0.113.80';
FLUSH PRIVILEGES;

Les écritures restent du côté du serveur de jeu, via les scripts FiveM, pour ne pas contourner les vérifications du framework. Si le site web tourne sur le même VPS que FXServer, derrière Apache ou nginx avec PHP, il partage le CPU et la RAM du serveur de jeu : surveillez la charge avant d'y ajouter un CMS complet. Pour un site public à fort trafic, un hébergement web séparé qui interroge la base en lecture depuis une adresse IP autorisée est préférable. Et si vous attachez un nom de domaine au serveur FiveM lui-même, le guide configurer un nom de domaine et un enregistrement SRV explique la partie DNS.

Sauvegarder et dimensionner la base

La base contient l'économie entière du serveur : un script qui vide une table par erreur ou un disque qui lâche efface des mois de progression. Dans le panel, exportez régulièrement la base depuis phpMyAdmin en plus des sauvegardes de l'hébergeur. Sur un VPS, planifiez un backup avec mariadb-dump et cron, puis copiez-le hors du serveur :

mariadb-dump -u fivem -p fivem | gzip > /home/backups/fivem-$(date +%F).sql.gz

La mise en place complète, rotation et envoi distant compris, est dans automatiser les sauvegardes MySQL avec mysqldump et cron, et le volet propre à FiveM (resources, txData) dans automatiser les sauvegardes d'un serveur FiveM.

Côté ressources, FXServer et MariaDB se partagent la machine. Le serveur de jeu charge surtout un cœur CPU ; MariaDB profite de la RAM pour garder les tables chaudes en mémoire et répondre aux requêtes sans toucher le disque. Sur un VPS, réservez-lui une part de la RAM via innodb_buffer_pool_size sans priver FXServer, et préférez un stockage SSD : chaque requête d'inventaire qui attend le disque se traduit par une saccade pour tous les joueurs connectés.

Choisir son framework avant de connecter la base

La base de données ne sert qu'à partir du moment où votre framework l'exploite. Si vous hésitez encore, notre guide ESX Legacy vs QBCore vous aide à trancher, puis Installer ESX Legacy sur un serveur FiveM détaille l'import des tables et le premier démarrage. Vous n'avez pas encore de serveur ? L'essai FiveM gratuit 48 h inclut une base MySQL et txAdmin pour tester toute cette procédure avant de choisir une offre.

FAQ

Quelle est la bonne syntaxe de mysql_connection_string ?

Deux formats équivalents : set mysql_connection_string "server=HOTE;port=3306;database=NOM;user=UTILISATEUR;password=MOT_DE_PASSE" ou set mysql_connection_string "mysql://UTILISATEUR:MOT_DE_PASSE@HOTE:3306/NOM". Dans le format clé=valeur, le port est une clé séparée, jamais collé à l'hôte.

MySQL ou MariaDB pour un serveur FiveM ?

Les deux fonctionnent avec oxmysql, qui parle le protocole MySQL. Sa documentation recommande MariaDB : la plupart des scripts FiveM ont été écrits pour MySQL 5.7 et certains échouent à l'import sur MySQL 8 à cause de mots-clés réservés ou de valeurs par défaut sur les colonnes JSON et longtext.

Peut-on utiliser PostgreSQL ou SQL Server ?

Non. oxmysql, ESX Legacy et QBCore ne fonctionnent qu'avec une base MySQL ou MariaDB. Une base PostgreSQL, SQL Server ou SQLite ne peut pas remplacer la base du serveur FiveM.

Pourquoi mon mot de passe bloque la connexion ?

Les caractères ; , / ? : @ & = + $ # sont réservés dans l'un ou l'autre format de chaîne de connexion et cassent son découpage. Utilisez un mot de passe long et alphanumérique, ou essayez l'autre format.

Puis-je utiliser la base MySQL de mon hébergement web (Plesk, CMS) ?

C'est déconseillé. Une base d'hébergement web mutualisé est prévue pour un site PHP servi sur la même machine : l'accès distant n'est pas toujours ouvert et chaque requête de FiveM traverserait Internet. Gardez la base dans le panel de votre hébergeur FiveM ou sur le VPS qui fait tourner FXServer.

Faut-il un accès root ou SSH pour lier la base ?

Non sur un hébergement FiveM avec panel : la base se crée dans le panel et s'administre avec phpMyAdmin. L'accès SSH avec un compte sudo n'est nécessaire que si vous installez MariaDB vous-même sur un VPS Linux ou un serveur dédié.

La base se connecte mais les données ne s'affichent pas ?

Vérifiez que le fichier .sql du framework a bien été importé (les tables doivent apparaître dans phpMyAdmin ou avec SHOW TABLES) et que l'utilisateur MariaDB a les privilèges sur cette base. Activez mysql_debug true pour voir les requêtes et leurs erreurs dans la console.