Contexte
Vous avez déjà un serveur FiveM qui tourne ailleurs, chez un autre hébergeur ou directement sur votre PC, et vous souhaitez le migrer vers Winheberg sans tout recommencer à zéro ? Bonne nouvelle, la procédure est plus simple qu'il n'y paraît, et vous conservez toutes vos ressources, votre base de données et la progression de vos joueurs.
Ce guide vous accompagne pas à pas dans la migration, que vous veniez d'un autre hébergeur ou de votre PC personnel, auto-hébergement, localhost ou machine de développement.
Avant de commencer, ce qu'il faut comprendre
Un serveur FiveM est composé de deux parties indissociables.
- Le dossier
resources/et le fichierserver.cfg, le contenu unique de votre serveur - La base de données MySQL, qui contient joueurs, économie, véhicules et inventaires
Pour que la migration soit complète, il faut transférer les deux. Si vous ne migrez que les fichiers, vos joueurs perdront toute leur progression. Si vous ne migrez que la base, votre serveur ne démarrera tout simplement pas.
Vous n'avez pas besoin de récupérer les artifacts FiveM, les binaires du serveur comme FXServer ou le dossier citizen/. Winheberg les fournit déjà sur votre instance, et vous choisissez la version souhaitée via le champ FIVEM VERSION dans Startup. Pour la procédure complète, consultez notre guide « Comment changer la version (artifacts) FiveM de son serveur ? ». Concentrez-vous uniquement sur le contenu unique à votre serveur, le dossier resources/, le server.cfg et votre base de données.
Pendant toute la durée de la migration, votre serveur d'origine doit être arrêté. Si vous le laissez tourner pendant que vous transférez la base de données, vous risquez de perdre les nouvelles données générées entre l'export et l'import.
Prérequis
- Un serveur FiveM actif chez Winheberg, prêt à recevoir vos fichiers
- FileZilla ou un autre client SFTP installé sur votre PC
- Vos identifiants SFTP Winheberg, visibles dans la section Settings de votre serveur, mot de passe identique à celui du panel
- Vos identifiants MySQL Winheberg, visibles dans la section Databases du panel
- L'accès à votre serveur d'origine, autre hébergeur ou PC, pour récupérer les fichiers et la base
Cas 1. Migration depuis un autre hébergeur
Si votre serveur FiveM tourne actuellement chez un autre hébergeur, quel qu'il soit, la procédure se déroule en 4 grandes étapes.
Si votre hébergeur actuel propose une fonctionnalité de sauvegarde téléchargeable, backup ou snapshot exportable, c'est souvent le moyen le plus simple de récupérer vos données. Une backup complète contient généralement à la fois vos fichiers et un export de votre base de données, ce qui vous évite de refaire séparément les étapes 2 et 3 ci-dessous. Téléchargez-la depuis le panel de votre hébergeur, puis extrayez-en le dossier resources/, le server.cfg et le fichier .sql de la base. Si votre hébergeur ne propose pas cette fonctionnalité, ou si vous préférez tout récupérer manuellement, suivez les étapes 2 et 3.
1. Arrêter votre serveur d'origine
Connectez-vous au panel de votre hébergeur actuel et arrêtez votre serveur FiveM. C'est crucial pour éviter toute perte de données pendant le transfert.
Prévenez vos joueurs avant l'arrêt. Une fois le serveur stoppé, ils ne pourront plus se connecter jusqu'à la fin de la migration. Planifiez idéalement l'opération aux heures creuses.
2. Récupérer le contenu unique de votre serveur via SFTP
Connectez-vous à votre serveur d'origine via SFTP et téléchargez uniquement le contenu propre à votre serveur, pas les artifacts FiveM.
- Ouvrez FileZilla
- Saisissez les identifiants SFTP de votre ancien hébergeur, host, port, username et password
- Connectez-vous
- Naviguez jusqu'au dossier racine de votre serveur FiveM
- Sélectionnez uniquement le dossier
resources/et le fichierserver.cfg - Téléchargez-les dans un dossier local de votre PC, par exemple
C:\migration-fivem\
Le téléchargement peut prendre plusieurs minutes à plusieurs heures selon la taille de votre serveur. Les serveurs RP chargés en ressources dépassent parfois plusieurs Go. Lancez-le en arrière-plan et enchaînez sur l'étape suivante.
Avant de passer par le SFTP, jetez un œil au panel de votre hébergeur actuel. Beaucoup proposent une section Backups ou Sauvegardes permettant de créer une archive complète du serveur et de la télécharger en un clic. Si cette option existe chez vous, elle remplace avantageusement les étapes SFTP ci-dessus, l'archive contient déjà votre dossier resources/ et votre server.cfg. Il vous suffira ensuite de l'extraire sur votre PC.
3. Exporter la base de données depuis l'ancien hébergeur
La méthode la plus universelle passe par phpMyAdmin, disponible chez la quasi-totalité des hébergeurs.
- Connectez-vous au phpMyAdmin de votre hébergeur actuel
- Sélectionnez la base de données de votre serveur FiveM dans le menu de gauche
- Cliquez sur l'onglet Exporter en haut
- Laissez les options par défaut, format SQL, méthode Rapide
- Cliquez sur Exporter pour télécharger le fichier
.sql - Sauvegardez ce fichier dans votre dossier de migration
Si votre hébergeur n'a pas phpMyAdmin, la commande mysqldump en SSH donne le même résultat, un fichier .sql contenant toute votre base. Demandez assistance à leur support si nécessaire.
4. Importer vos fichiers et votre base chez Winheberg
Vous avez maintenant les deux éléments sur votre PC, que vous soyez passé par une backup téléchargée ou par la récupération manuelle. Passez à la section Importer vos fichiers chez Winheberg plus bas, commune aux deux cas de figure.
Cas 2. Migration depuis votre PC
Si vous avez développé votre serveur FiveM en local, avec MySQL Workbench, XAMPP, WAMP, Laragon ou un autre outil, la procédure est très proche, mais sans étape SFTP côté origine puisque les fichiers sont déjà chez vous.
1. Localiser le contenu de votre serveur
Repérez le dossier où vous avez installé votre serveur FiveM sur votre PC. Selon votre installation, il peut se trouver à un emplacement de ce type.
C:\FXServer\server-data\, installation classique WindowsD:\Mon-Serveur-RP\C:\Users\VotreNom\Desktop\FiveM-Server\
Dans ce dossier, vous devez retrouver au minimum un server.cfg et un dossier resources/. Ce sont les deux seuls éléments à uploader chez Winheberg. Les binaires FXServer.exe, les dossiers citizen/ et cache/ sont inutiles, Winheberg fournit déjà tout cela côté serveur.
2. Préparer les fichiers pour l'upload
Vous n'allez uploader que deux choses chez Winheberg.
- Le dossier
resources/complet, vos scripts, vos frameworks et votre RP - Le fichier
server.cfg, votre configuration
Profitez-en pour faire un petit nettoyage avant d'uploader.
- Supprimez les ressources que vous n'utilisez plus
- Vérifiez que votre
server.cfgne contient pas d'éléments spécifiques à votre PC, chemins absolus locaux,127.0.0.1oulocalhost
3. Exporter votre base de données locale
Selon l'outil que vous utilisez en local, la méthode diffère légèrement.
- MySQL Workbench, allez dans Server → Data Export, sélectionnez votre base, choisissez Export to Self-Contained File et exportez en
.sql - phpMyAdmin (XAMPP, WAMP, Laragon), ouvrez phpMyAdmin via
http://localhost/phpmyadmin, sélectionnez votre base, onglet Exporter, format SQL, puis Exporter - HeidiSQL, clic droit sur la base, Exporter une base de données en SQL, puis choisissez le fichier de destination
Sauvegardez le fichier .sql à côté de votre dossier serveur.
4. Importer vos fichiers et votre base chez Winheberg
Comme pour le cas 1, passez à la section commune ci-dessous.
Importer vos fichiers chez Winheberg
Cette section est commune aux deux cas de figure. Vous devez maintenant uploader vos fichiers et votre base de données sur votre serveur Winheberg.
1. Se connecter en SFTP à votre serveur Winheberg
- Ouvrez FileZilla
- Récupérez vos identifiants SFTP dans la section Settings de votre serveur sur le panel Winheberg
- Saisissez les informations dans FileZilla, host, port et username
- Pour le mot de passe, utilisez celui de votre compte panel Winheberg, c'est le même
- Connectez-vous
2. Uploader resources/ et server.cfg
- Dans FileZilla, sur la partie droite (serveur distant), naviguez jusqu'à
/home/container/ - Sur la partie gauche (local), naviguez jusqu'à votre dossier de migration
- Sélectionnez le dossier
resources/et le fichierserver.cfguniquement - Glissez-déposez-les vers
/home/container/ - Patientez pendant le transfert
Pour les gros transferts de plusieurs Go, utilisez la file d'attente de FileZilla et lancez le tout d'un coup. Le SFTP est stable et reprend en cas d'interruption mineure.
N'uploadez pas d'autres fichiers que resources/ et server.cfg. Les artifacts FiveM comme FXServer ou citizen/ sont déjà gérés par Winheberg, et écraser ces fichiers peut casser votre serveur. Si vous avez d'autres fichiers personnalisés, copiez-les seulement après avoir vérifié qu'ils n'entrent pas en conflit.
Importer votre base de données chez Winheberg
1. Accéder à phpMyAdmin
- Sur votre panel Winheberg, allez dans la section Databases
- Cliquez sur l'icône phpMyAdmin, ou utilisez le lien direct fourni
- Connectez-vous avec les identifiants MySQL de votre base Winheberg
2. Importer le fichier .sql
- Dans phpMyAdmin, sélectionnez votre base Winheberg dans le menu de gauche
- Cliquez sur l'onglet Importer en haut
- Cliquez sur Choisir un fichier et sélectionnez le
.sqlexporté précédemment - Laissez les options par défaut
- Cliquez sur Importer en bas
- Patientez pendant l'import, cela peut prendre quelques minutes selon la taille
Si votre fichier .sql est trop volumineux pour phpMyAdmin, découpez-le en plusieurs fichiers ou contactez notre support pour un import direct côté serveur.
Adapter votre server.cfg
Avant de démarrer votre serveur, quelques lignes du server.cfg doivent être adaptées à votre nouvelle infrastructure Winheberg.
Modifier la chaîne de connexion MySQL
Repérez la ligne set mysql_connection_string dans votre server.cfg et remplacez les anciens identifiants par vos nouveaux identifiants Winheberg, host, utilisateur, mot de passe et nom de base.
Pour la procédure complète, avec la bonne syntaxe et les caractères à éviter dans le mot de passe, consultez notre guide « Comment connecter son serveur FiveM à une base de données MySQL ? ».
Vérifier la License Key
La ligne sv_licenseKey doit contenir votre License Key FiveM, aussi désignée Server Registration Key. Si vous avez plusieurs clés sur le portail Cfx.re (portal.cfx.re), utilisez celle générée pour votre nouveau serveur Winheberg, avec son hostname au format gm1-whXX.wh-game.fr.
Vérifier les endpoints du serveur
Dans votre server.cfg, les lignes endpoint_add_tcp et endpoint_add_udp doivent utiliser l'adresse 0.0.0.0 suivie du port attribué à votre serveur par Winheberg, visible sur la page principale de votre serveur dans le panel.
endpoint_add_tcp "0.0.0.0:30XXX"
endpoint_add_udp "0.0.0.0:30XXX"
Le port 30XXX est un placeholder. Winheberg attribue à chaque serveur un port unique, par exemple 30247 ou 30815, que vous retrouvez sur la page principale de votre serveur dans le panel. L'adresse 0.0.0.0 indique au serveur d'écouter sur toutes les interfaces réseau, c'est la valeur correcte sur notre infrastructure. Ne mettez pas l'adresse publique de votre serveur en dur, cela ne fonctionnera pas.
Démarrer votre serveur migré
Tout est en place, vous pouvez maintenant démarrer votre serveur.
- Retournez sur la page principale de votre serveur dans le panel Winheberg
- Cliquez sur Start
- Surveillez la console attentivement, c'est là qu'apparaissent les éventuelles erreurs
Si tout va bien, votre serveur démarre, vos ressources se chargent une à une dans la console, et vous pouvez vous y connecter avec votre client FiveM. La migration est réussie 🎉
En cas de problème
❌ Le serveur ne démarre pas, erreur MySQL
Si vous voyez des erreurs de type Can't connect to MySQL ou Access denied dans la console.
- Vérifiez la chaîne de connexion dans votre
server.cfg, utilisateur, mot de passe, host et nom de base - Vérifiez que votre mot de passe ne contient pas de caractères problématiques
- Vérifiez que vous utilisez bien l'hôte Winheberg fourni dans votre panel, section Databases, et pas votre ancien hôte
- Testez la connexion via phpMyAdmin pour confirmer que vos identifiants fonctionnent
❌ Des ressources ne se chargent pas
Si certaines ressources affichent Couldn't start resource X.
- Vérifiez que la ressource est bien présente dans
/home/container/resources/ - Vérifiez les dépendances de la ressource, souvent listées dans son
fxmanifest.lua - Comparez avec votre ancien serveur, une ressource a peut-être été oubliée dans le transfert
❌ Les joueurs ne retrouvent pas leur progression
Si les joueurs se connectent mais reviennent au niveau 0.
- L'import de la base a peut-être échoué partiellement, vérifiez dans phpMyAdmin que toutes les tables sont présentes avec leurs données
- Le
server.cfgpointe peut-être vers la mauvaise base, une base de test vide par exemple, vérifiez la chaîne de connexion - Certains frameworks gardent un cache local des joueurs, redémarrez le serveur pour forcer le rechargement
❌ Le fichier .sql est trop gros pour phpMyAdmin
phpMyAdmin a une limite d'upload qui peut bloquer les très grosses bases.
- Découpez votre fichier
.sqlen plusieurs morceaux, table par table par exemple - Compressez le fichier en
.sql.gzavant l'upload, phpMyAdmin sait le lire directement - Contactez notre support pour un import direct côté serveur
❌ Mon serveur démarre mais personne ne peut se connecter
Si le serveur démarre sans erreur mais qu'aucun joueur n'arrive à se connecter.
- Vérifiez que votre License Key correspond bien à votre serveur Winheberg
- Vérifiez l'adresse de connexion communiquée à vos joueurs, au format
gm1-whXX.wh-game.fr:port - Vérifiez que le serveur apparaît bien dans la liste publique FiveM. Pour le référencement complet, consultez notre guide « Comment référencer son serveur FiveM sur la liste Cfx.re ? »
Bonnes pratiques
- Faites un backup complet avant de toucher à quoi que ce soit, fichiers et base de données, et gardez-le en cas de retour en arrière
- Migrez d'abord en mode test sans annoncer à vos joueurs, vérifiez que tout fonctionne avant de communiquer
- Planifiez la migration aux heures creuses pour limiter la gêne pour vos joueurs
- Prévenez vos joueurs à l'avance sur Discord ou en jeu, idéalement la veille
- Documentez votre migration pour vous rappeler les ajustements effectués en cas de souci futur
- Ne supprimez pas votre ancien serveur immédiatement, gardez-le quelques jours au cas où
Besoin d'aide ?
Si vous rencontrez un problème lors de la migration, transfert qui échoue, base trop volumineuse ou erreurs MySQL persistantes, notre équipe est là. Ouvrez un ticket dans le département Technique depuis votre espace client et renseignez le champ Produit lié avec le serveur concerné.
Bienvenue chez Winheberg, bonne aventure RP avec votre serveur migré 🎮
