Migrer un serveur FiveM existant vers VeryCloud

Introduction

Migrer un serveur FiveM peut sembler intimidant, mais c'est en réalité assez simple : tout est dans 2 dossiers (artifacts + server-data) et 1 base de données MySQL. Ce guide détaille la procédure complète, y compris les pièges classiques (caractères MySQL, chemins absolus dans la config, licence Cfx.re).

Prérequis

• Un VPS VeryCloud déjà commandé (Debian 12 / Ubuntu 22.04+ recommandé)
• Accès root au VPS de destination
• Accès SSH ou panel sur l'ancien serveur (Zap, autre hébergeur)
• Un client SFTP type FileZilla ou WinSCP

Étape 1 : Préparer le VPS de destination

Suivez d'abord le tuto FiveM + txAdmin pour installer les artifacts, MariaDB et créer l'utilisateur fivem.

À la fin de cette étape, vous avez :

• /home/fivem/server/ : artifacts FiveM
• /home/fivem/server-data/ : dossier vide (sera remplacé)
• MariaDB installé et user fivem créé

Étape 2 : Exporter la base de données depuis l'ancien serveur

Sur l'ancien serveur, ouvrez un terminal SSH et exportez la base :

mysqldump -u USER_ANCIEN -p NOM_BASE > fivem-backup.sql

Si vous êtes sur Zap, phpMyAdmin ou un panel, utilisez la fonction Exporter → SQL depuis l'interface.

Téléchargez le fichier fivem-backup.sql en local.

Astuce : si la base est très grande (>500 MB), compressez-la avant transfert :

gzip fivem-backup.sql

Étape 3 : Archiver le dossier server-data

Sur l'ancien serveur :

cd /chemin/vers/server-data/..
tar -czf server-data-backup.tar.gz server-data/

Téléchargez server-data-backup.tar.gz en local.

Sur Zap ou hébergeur similaire avec accès limité, utilisez SFTP pour télécharger tout le dossier resources/, cache/, server.cfg, etc.

Note importante : excluez le dossier cache/ du transfert, il sera régénéré au démarrage. Il peut faire plusieurs Go et ralentir inutilement.

tar -czf server-data-backup.tar.gz --exclude='server-data/cache' server-data/

Étape 4 : Transférer les fichiers vers VeryCloud

Depuis votre machine locale, utilisez scp ou SFTP pour uploader sur le VPS VeryCloud :

scp fivem-backup.sql root@IP_VPS_VERYCLOUD:/tmp/
scp server-data-backup.tar.gz root@IP_VPS_VERYCLOUD:/tmp/

Ou via FileZilla/WinSCP en SFTP sur le port 22.

Étape 5 : Importer la base de données

Sur le VPS VeryCloud :

sudo mysql -u root -p

CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
GRANT ALL PRIVILEGES ON fivem.* TO 'fivem'@'localhost';
EXIT;

Importez le dump :

sudo mysql -u root -p fivem < /tmp/fivem-backup.sql

Vérifiez :

sudo mysql -u root -p -e "USE fivem; SHOW TABLES;"

Étape 6 : Restaurer le dossier server-data

sudo su - fivem
cd ~
rm -rf server-data
tar -xzf /tmp/server-data-backup.tar.gz
chown -R fivem:fivem server-data

Étape 7 : Adapter la configuration

Éditez server.cfg :

nano ~/server-data/server.cfg

Modifiez :

Licence Cfx.re

L'ancienne licence est liée à l'ancienne IP. Récupérez-la depuis https://keymaster.fivem.net et mettez à jour l'IP dans le panel keymaster (bouton "Edit" sur la clé).

OU créez une nouvelle clé avec l'IP du VPS VeryCloud.

sv_licenseKey "votre-nouvelle-cle-cfx"

Chemins absolus

Si l'ancienne config contient des chemins absolus du style /home/zap/..., remplacez-les par les nouveaux chemins :

grep -r "/home/zap" ~/server-data/
sed -i 's|/home/zap|/home/fivem|g' ~/server-data/server.cfg

IP du listing public

sets sv_listingHostOverride "IP_VPS_VERYCLOUD:30120"

Connexion MySQL

Cherchez les ressources qui se connectent à MySQL (oxmysql, mysql-async, ghmattimysql). La connexion est généralement définie dans :

grep -r "mysql_connection_string\|set mysql" ~/server-data/server.cfg

Adaptez :

set mysql_connection_string "server=localhost;database=fivem;userid=fivem;password=MotDePasseSecurise!"

Étape 8 : Premier démarrage

Lancez txAdmin :

~/server/run.sh

Connectez-vous au panel txAdmin (http://IP:40120) avec vos identifiants existants ou créez un nouveau compte.

Démarrez le serveur. Inspectez les logs : tout doit charger sans erreur. Si une ressource crash, vous verrez l'erreur dans la console live.

Étape 9 : Tester depuis le client

Lancez GTA V → FiveM → F8 → :

connect IP_VPS_VERYCLOUD:30120

Vérifiez :

• Connexion réussie
• Vos données sont là (personnages, inventaire, argent, véhicules)
• Les ressources fonctionnent (commandes, scripts)

Étape 10 : Migrer le DNS et basculer

Si vous avez un domaine pointant vers votre serveur FiveM, mettez à jour les enregistrements DNS chez votre registrar :

A     fivem.votre-domaine.com    →   IP_VPS_VERYCLOUD

TTL : 300 secondes pendant la migration (pour propagation rapide).

Une fois migré et stable, communiquez la nouvelle IP / nouveau nom à votre communauté.

Étape 11 : Configurer le service systemd

Pour les démarrages automatiques (voir le tuto FiveM + txAdmin étape 10) :

sudo systemctl enable --now fivem

Étape 12 : Conserver l'ancien serveur en standby (recommandé)

Ne supprimez pas l'ancien serveur immédiatement. Gardez-le en standby au moins 7 jours :

• Permet de récupérer des données en cas de problème
• Permet de comparer si quelque chose ne fonctionne pas comme avant
• Sauvegarde de sécurité supplémentaire

Au bout d'une semaine sans souci, vous pouvez résilier.

Dépannage

Caractères mal encodés (é, è, à...)

L'import s'est fait avec un mauvais charset. Re-créez la base et importez avec :

mysql -u root -p --default-character-set=utf8mb4 fivem < /tmp/fivem-backup.sql

Ressource refuse de démarrer

Comparez les versions des ressources avec l'ancien serveur. Souvent : la version installée n'est pas la même. Inspectez le fxmanifest.lua et vérifiez les dépendances.

"Couldn't find resource X"

Le dossier [local]/ ou un dossier de ressources n'a pas été correctement transféré. Re-comparez les arborescences entre ancien et nouveau serveur :

diff <(ssh ancien-serveur "ls /chemin/server-data/resources") <(ls ~/server-data/resources)

Joueurs ne peuvent pas se connecter mais le serveur tourne

Vérifiez que les ports 30120 (TCP+UDP) sont bien ouverts dans :

• UFW : sudo ufw status
• Netrix (espace client VeryCloud)
• server.cfg : endpoint_add_tcp "0.0.0.0:30120" et endpoint_add_udp "0.0.0.0:30120"

Migration depuis Zap-Hosting (cas particulier)

Zap utilise souvent une version forkée d'artifacts et un chemin /games/.../. Pour récupérer le dossier server-data depuis Zap :

1. Allez dans Panel Zap → Gérer → SFTP/Backup
2. Téléchargez l'archive complète
3. Décompressez localement, identifiez les dossiers resources/, server.cfg, et la base MySQL exportée depuis phpMyAdmin Zap

Commandes utiles

# Vérifier la taille de chaque ressource (utile pour diagnostiquer)
du -sh ~/server-data/resources/* | sort -h

# Compter les tables dans la base
sudo mysql -u root -p -e "USE fivem; SHOW TABLES;" | wc -l

# Sauvegarder en un coup avant migration finale
tar -czf full-backup.tar.gz ~/server-data /etc/mysql
mysqldump -u root -p --all-databases | gzip > all-databases.sql.gz

# Vérifier que le port 30120 répond
nc -zvu IP_VPS_VERYCLOUD 30120

Conclusion

La migration est faite, votre communauté joue sur un VPS VeryCloud avec performances optimales et un support technique français. Pour une migration entièrement gérée par les équipes VeryCloud, ouvrez un ticket support : nous proposons une prestation de migration gratuite sur les offres VPS Gaming et Dédiés.

Ressources

• Tuto VeryCloud — Installer FiveM + txAdmin : /docs/article/fivem-txadmin-install
• Tuto VeryCloud — Diagnostiquer un crash FiveM : /docs/article/fivem-debug-crash
• Documentation officielle FiveM : https://docs.fivem.net
• Keymaster Cfx.re : https://keymaster.fivem.net