---
title: "Comment connecter son serveur FiveM à une base de données MySQL ?"
description: "Configurez la connexion MySQL de votre serveur FiveM chez Winheberg, chaîne de connexion, sécurité du mot de passe et résolution des erreurs courantes."
category: jeux
subcategory: fivem
icon: tabler:file-text
date: 2026-07-24
author: Winheberg
slug: "connexion-mysql-serveur-fivem"
order: 15
image: /statics/images/docs/fr/gaming/fivem/connexion-mysql-serveur-fivem.webp
tags: [fivem, mysql, base de données, oxmysql, configuration]
keywords: [fivem mysql, connexion base de données fivem, oxmysql configuration, mysql_connection_string, serveur fivem winheberg]
link_en: "/en/docs/fivem/connect-mysql-fivem-server"
---
## Contexte
Vous gérez un **serveur FiveM** (GTA RP) et vous voulez le connecter à une **base de données MySQL** pour stocker les comptes joueurs, l'inventaire, les véhicules, l'argent ou tout autre élément persistant ? Que vous utilisiez **oxmysql**, **ghmattimysql** ou un autre connecteur, la configuration se fait toujours via la même variable `mysql_connection_string` dans votre `server.cfg`.
Ce guide vous explique pas à pas comment configurer cette connexion correctement, avec les bonnes pratiques de sécurité et la résolution des erreurs les plus fréquentes.
> [!IMPORTANT]
> Assurez-vous que les informations sensibles telles que les mots de passe sont sécurisées et ne sont pas partagées publiquement. Ne commitez jamais votre `server.cfg` sur un dépôt Git public, même temporairement.
## Prérequis
Avant de commencer, assurez-vous d'avoir les éléments suivants.
- Un **serveur FiveM** actif sur votre panel gaming Winheberg
- Un **connecteur MySQL** installé sur votre serveur FiveM (oxmysql, ghmattimysql, mysql-async, etc.)
## 1. Créer une base de données depuis le panel gaming
La création de votre base de données se fait directement depuis le **panel gaming Winheberg**, dans la section dédiée de votre serveur FiveM.
1. Connectez-vous à votre **panel gaming Winheberg**
2. Rendez-vous sur votre serveur FiveM
3. Ouvrez l'onglet **Databases**
4. Cliquez sur **Create Database** (ou équivalent) pour créer une nouvelle base
Une fois la base créée, vous obtiendrez un nom de base, un nom d'utilisateur et un mot de passe. Ces informations apparaîtront immédiatement dans le tableau des bases de données.
## 2. Récupérer la chaîne de connexion prête à l'emploi
Pour vous simplifier la vie, Winheberg génère automatiquement la **chaîne de connexion complète** dans la section **Database Details**.
1. Cliquez sur votre base de données fraîchement créée
2. Descendez jusqu'à la section **Database Details**
3. Repérez la ligne **Fxserver Database** qui contient la `mysql_connection_string` prête à copier
Cette ligne ressemble à ceci.
```bash
set mysql_connection_string "server=dbXX.wh-nodes.net;database=sxx_Exemple;userid=uxxx_Exemple;password=MOT_DE_PASSE"
```
Il vous suffit ensuite de la copier dans votre `server.cfg`.
> [!WARNING]
> Si votre mot de passe contient des caractères comme `=`, `;`, `"` ou `'`, le parsing de la chaîne de connexion va échouer (notamment avec OXMYSQL). Dans ce cas, **régénérez le mot de passe** depuis le panel (option **Rotate password** ou équivalent) jusqu'à obtenir un mot de passe propre. Voir la section "Mot de passe contenant des caractères problématiques" plus bas.
## 3. Ajouter la chaîne dans server.cfg
Ouvrez votre fichier `server.cfg` (à la racine de votre serveur FiveM) et **collez la ligne** que vous venez de copier depuis le panel.
```bash
set mysql_connection_string "server=dbXX.wh-nodes.net;database=sxx_Exemple;userid=uxxx_Exemple;password=VOTRE_MOT_DE_PASSE"
```
Si la ligne `mysql_connection_string` existe déjà dans votre `server.cfg`, **remplacez-la** entièrement par la nouvelle.
## 4. Redémarrer votre serveur FiveM
Après avoir sauvegardé les modifications, **redémarrez complètement votre serveur** pour que la nouvelle configuration soit prise en compte. Un simple `restart` d'une ressource ne suffit pas, car la `mysql_connection_string` est chargée au démarrage du serveur.
## 5. Vérifier la connexion
Une fois le serveur redémarré, consultez les logs FiveM. Si la connexion fonctionne, vous devriez voir un message du type.
```
[oxmysql] Database server connection established!
```
Si vous voyez une erreur à la place, consultez la section "En cas de problème" en fin de guide.
## Mot de passe contenant des caractères problématiques
Certains caractères spéciaux (`=`, `;`, `"`, `'`) sont utilisés dans la **syntaxe même** de la `mysql_connection_string` et empêcheront le bon parsing de la chaîne. C'est particulièrement le cas avec **OXMYSQL**, qui est très strict.
Si votre mot de passe contient l'un de ces caractères, la solution la plus simple est de **régénérer le mot de passe** depuis le panel.
1. Retournez dans l'onglet **Databases** du panel gaming
2. Cliquez sur votre base de données
3. Utilisez l'option **Rotate password** (ou équivalent)
4. Vérifiez que le nouveau mot de passe ne contient aucun des caractères problématiques
5. Si nécessaire, recommencez la rotation jusqu'à obtenir un mot de passe propre
6. Récupérez à nouveau la chaîne **Fxserver Database** mise à jour dans **Database Details**
7. Remplacez-la dans votre `server.cfg` et redémarrez votre serveur
## Bonnes pratiques de sécurité
Quelques règles à respecter pour sécuriser votre connexion MySQL.
- **Ne partagez jamais votre `server.cfg`** sur des forums ou GitHub publics, il contient votre mot de passe MySQL en clair
- **Régénérez votre mot de passe** depuis le panel si vous suspectez une fuite, par exemple si vous avez accidentellement partagé votre `server.cfg`
- **Faites des sauvegardes régulières** de votre base de données avec `mysqldump` ou via le panel
- **Ne donnez pas l'accès au panel** à des personnes non autorisées, elles pourraient voir votre mot de passe MySQL en clair dans Database Details
## En cas de problème
Voici les erreurs les plus fréquentes que vous pourriez rencontrer.
### ❌ Access denied for user
Le nom d'utilisateur ou le mot de passe est incorrect. Vérifiez les points suivants.
- Que vous avez bien recopié la ligne complète depuis **Database Details** sans tronquer
- Que le mot de passe ne contient pas de caractères interdits (`=`, `;`, `"`, `'`), si c'est le cas, régénérez-le depuis le panel
- Qu'il n'y a pas d'espace en trop avant ou après les valeurs dans votre `mysql_connection_string`
### ❌ Can't connect to MySQL server
FiveM n'arrive pas à joindre le serveur MySQL. Vérifiez les points suivants.
- Que l'adresse du serveur (`dbXX.wh-nodes.net`) est correctement orthographiée dans votre `mysql_connection_string`
- Que votre base de données est bien active dans le panel gaming, pas suspendue ou supprimée
- Que votre serveur FiveM dispose bien d'un accès réseau sortant, normalement toujours le cas chez Winheberg
### ❌ Le serveur démarre mais aucune donnée n'est sauvegardée
Consultez les logs FiveM au démarrage. Vous y verrez probablement une erreur de connexion silencieuse. Si vous utilisez oxmysql, lancez la commande suivante dans la console FiveM pour activer le mode debug.
```
oxmysql_debug true
```
Cela activera les logs détaillés des requêtes MySQL et vous aidera à identifier le problème.
### ❌ Unknown collation 'utf8mb4_0900_ai_ci'
Cette erreur arrive quand vous importez une base de données exportée depuis MySQL 8 vers MariaDB. Avant d'importer, remplacez dans votre fichier SQL toutes les occurrences de `utf8mb4_0900_ai_ci` par `utf8mb4_unicode_ci`.
## Besoin d'aide ?
Si malgré ces étapes votre serveur FiveM ne se connecte toujours pas à MySQL, notre équipe est là. Ouvrez un ticket dans le département **Technique** depuis votre espace client, renseignez le champ **Produit lié** avec le serveur concerné, et joignez les logs de démarrage de votre serveur FiveM.
Votre serveur FiveM est maintenant connecté à sa base de données et prêt à sauvegarder les données de vos joueurs 🎮