Un serveur qui ne démarre plus après une mise à jour, des ressources qui se marchent dessus après des mois d'ajouts, un framework que vous voulez changer (passer d'ESX à QBCore, par exemple) : à un moment, repartir d'un serveur FiveM propre coûte moins de temps que de tout déboguer. Sur un hébergement FiveM avec panel, il suffit en apparence d'un bouton. Le bouton Reinstall Server de Pterodactyl ne vide pourtant pas le serveur : il relance le script d'installation, et la plupart de vos fichiers restent en place.
Ce guide s'adresse à ceux qui administrent le serveur. Il détaille ce que la réinstallation efface réellement, la sauvegarde à faire avant, la méthode pour une vraie remise à zéro depuis le panel, puis l'équivalent sur un VPS Linux ou un serveur dédié où vous avez l'accès root.
Réinitialiser, restaurer ou réparer : choisir la bonne option
La réinitialisation est l'option la plus lourde. Avant de la lancer, vérifiez qu'une solution plus légère ne suffit pas :
| Situation | Option adaptée |
|---|---|
| Le serveur plante depuis l'ajout d'une ressource | Retirer sa ligne ensure dans server.cfg et redémarrer |
| Une mise à jour a tout cassé et une sauvegarde d'avant existe | Restaurer ce backup depuis le panel |
| Binaires FXServer corrompus ou build trop ancien | Réinstaller sans supprimer les fichiers : le script retélécharge FXServer |
| Changement de framework, configuration illisible, script piégé | Remise à zéro complète : sauvegarde, suppression des fichiers, réinstallation |
| Serveur lent ou à court de mémoire | Aucune réinitialisation : c'est un problème de ressources |
Le dernier cas revient souvent. Effacer puis réinstaller ne change ni le CPU, ni la RAM, ni l'espace disque, ni la bande passante de votre offre : ces ressources ne sont pas illimitées, et un serveur qui saturait sa mémoire saturera de nouveau dès que vous aurez remis les mêmes scripts. Commencez plutôt par notre guide pour optimiser les performances d'un serveur FiveM.
Sauvegarder avant de toucher au bouton
Listez d'abord ce que vous voulez retrouver après la réinitialisation :
server.cfget les fichiers.cfgqu'il charge avecexec: nom du serveur, ressources lancées, chaîne de connexion MySQL ;- le dossier
resources/, au moins vos ressources personnalisées ou achetées (celles de cfx-server-data se retéléchargent) ; - le dossier
txDatasi vous utilisez txAdmin : il contient ses journaux, sa configuration et ses données ; - la base de données MySQL ou MariaDB : personnages, inventaires, véhicules, économie ;
- votre clé de licence
sv_licenseKey, que vous retrouvez sur le portail Cfx.re (portal.cfx.re) si vous l'avez perdue.
Le backup du panel. L'onglet Backups de Pterodactyl crée une archive des fichiers du serveur en un clic, dans la limite du nombre de sauvegardes fixé par votre hébergeur. Verrouillez-la avec Lock : une sauvegarde verrouillée est protégée des suppressions automatiques ou accidentelles. Cette archive ne contient que les fichiers. La base de données vit sur un serveur MySQL séparé et s'exporte à part.
Une copie hors du serveur. Une sauvegarde rangée sur la même infrastructure que le serveur ne vous protège pas de tout. Téléchargez l'archive avec Download, ou récupérez les fichiers en SFTP, puis gardez-la sur votre PC ou dans un espace de stockage cloud. Pterodactyl ne propose pas de FTP classique : l'accès aux fichiers passe par SFTP, un transfert chiffré qui s'appuie sur SSH. Les informations de connexion sont dans l'onglet Settings, bloc SFTP Details : une adresse de la forme sftp://adresse-ip:port, un nom d'utilisateur de la forme utilisateur.identifiant, et le mot de passe de votre compte panel. FileZilla ou WinSCP s'y connectent en choisissant le protocole SFTP.
La base de données. Si votre panel donne accès à phpMyAdmin, ouvrez la base, choisissez Exporter au format SQL et gardez le fichier .sql. Les deux méthodes, phpMyAdmin et ligne de commande, ainsi que la restauration, sont détaillées dans notre guide pour sauvegarder et restaurer la base MySQL d'un serveur FiveM.
Ce que fait vraiment le bouton Reinstall Server
Dans Pterodactyl, le bouton se trouve dans l'onglet Settings (Paramètres si votre panel est traduit), bloc Reinstall Server. Le panel annonce la couleur : la réinstallation arrête le serveur, relance le script d'installation qui l'a créé, et certains fichiers peuvent être supprimés ou modifiés. Côté Wings, le service qui exécute les serveurs de jeu sur la machine, le code est encore plus précis : la réinstallation ne touche aux fichiers existants que si le script les modifie.
Tout dépend donc de l'egg, le modèle d'installation choisi par l'hébergeur. Avec l'egg FiveM communautaire le plus répandu (dépôt pelican-eggs), voici ce que devient chaque élément :
| Élément | Après Reinstall Server |
|---|---|
| Binaires FXServer | Retéléchargés : build recommandé par défaut, ou la version indiquée dans la variable de démarrage |
| Ressources par défaut (cfx-server-data) | Recopiées dans resources/, en écrasant les fichiers du même nom |
| Vos ressources personnalisées | Conservées, sauf fichier portant le même nom qu'une ressource par défaut |
server.cfg | Conservé, seule la ligne set gamename est réécrite ; recréé depuis un modèle uniquement s'il n'existe pas |
Dossier txData | Non touché par le script |
| Base MySQL ou MariaDB | Non touchée : elle est hébergée hors du dossier du serveur |
| Variables de démarrage (licence, slots, txAdmin) | Conservées : elles sont enregistrées dans le panel |
| Adresse IP et port | Inchangés |
| Sauvegardes | Conservées |
Conséquence pratique : sur un serveur dont la configuration est cassée, cliquer seul sur Reinstall Server répare les binaires mais laisse en place le server.cfg fautif et les ressources en conflit. Un hébergeur qui utilise un egg maison peut obtenir un autre résultat : en cas de doute, demandez au support avant de cliquer.
Si le bloc affiche un message indiquant que la réinstallation est désactivée, l'egg est configuré pour sauter son script d'installation. Seul un administrateur de l'hébergeur peut alors relancer l'installation : ouvrez un ticket.
Remise à zéro complète depuis le panel
Pour repartir d'un serveur réellement vierge, la suppression des fichiers se fait à la main, avant la réinstallation :
- Faites la sauvegarde décrite plus haut et vérifiez que l'archive s'ouvre bien sur votre PC.
- Arrêtez le serveur depuis la console du panel (bouton Stop).
- Ouvrez l'onglet Files (gestionnaire de fichiers), cochez tous les fichiers et dossiers, puis supprimez-les. Pour garder txAdmin et son historique, laissez
txDataen place ; pour un txAdmin vierge, supprimez-le aussi. - Dans Settings, cliquez sur Reinstall Server et confirmez. Le script retélécharge FXServer, recrée
resources/et unserver.cfgde base. - Côté base de données, ouvrez l'onglet Databases et créez une base vide plutôt que de supprimer l'ancienne : vous gardez ainsi un retour arrière tant que la nouvelle installation n'est pas validée. Notez ses identifiants, ils iront dans la chaîne de connexion.
- Démarrez le serveur et lisez la console jusqu'au bout avant de réimporter quoi que ce soit.
Chez ElypseCloud, le panel s'ouvre depuis votre espace client, et chaque offre de serveur FiveM comprend au moins trois bases SQL : assez pour garder l'ancienne base le temps de vérifier la nouvelle.
Revenir à un état connu plutôt qu'à zéro. Si vous disposez d'un backup propre d'avant le problème, la restauration (Restore) propose la case Delete all files before restoring backup : le panel efface tous les fichiers puis remet l'archive. C'est souvent plus rapide qu'une réinstallation suivie d'une reconfiguration complète. Notre guide sur les sauvegardes Pterodactyl et la restauration d'un serveur détaille la méthode.
Réinitialiser FiveM sur un VPS Linux ou un serveur dédié
Sur un serveur virtuel (VPS) ou un serveur dédié, pas de bouton tout prêt : vous avez l'accès root en SSH et c'est vous qui reconstruisez. Deux niveaux sont possibles.
Réinstaller seulement FiveM. Connecté en SSH, arrêtez FXServer (adaptez le nom du service si vous l'avez déclaré dans systemd), archivez l'ancien dossier et exportez la base, puis suivez la méthode d'installation Linux de la documentation officielle FiveM :
sudo systemctl stop fivem
tar czf ~/fivem-avant-reset.tar.gz -C ~ FXServer
mysqldump -u fivem -p base_fivem > ~/base_fivem.sql
mv ~/FXServer ~/FXServer.ancien
mkdir -p ~/FXServer/server
cd ~/FXServer/server && wget URL_DU_BUILD_RECOMMANDE
tar xf fx.tar.xz
git clone https://github.com/citizenfx/cfx-server-data.git ~/FXServer/server-data
Créez ensuite server.cfg dans server-data, puis lancez le serveur depuis ce dossier avec bash ~/FXServer/server/run.sh +exec server.cfg. Si vous préférez txAdmin, il écoute par défaut sur le port 40120 et range ses données dans un dossier txData situé à côté de run.sh. Pour que le serveur redémarre seul au boot, déclarez-le comme service : voir notre guide pour créer un service systemd pour un serveur de jeu.
Réinstaller tout le système. Si le serveur a été compromis ou si vous voulez changer de distribution (passer d'Ubuntu à Debian, par exemple), réinstallez l'OS depuis le panneau de contrôle du VPS. Sur les VPS Linux ElypseCloud, la réinstallation du système se fait depuis l'espace client, sans ticket, et un mode secours permet de récupérer des données sur un serveur qui ne démarre plus. Une réinstallation de l'OS efface tout le disque : bases MariaDB, clés SSH, règles de firewall. Il faudra donc reconfigurer :
- l'accès SSH par clé, avant de couper les mots de passe : voir configurer une clé SSH sans perdre l'accès ;
- le firewall : le port 30120 en TCP et en UDP pour les joueurs, et le port 40120 en TCP seulement si txAdmin doit être joignable, idéalement depuis votre seule adresse IP ;
- MariaDB, la base et l'utilisateur dédié, puis l'import du fichier
.sql.
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow from VOTRE_ADRESSE_IP to any port 40120 proto tcp
Pour aller plus loin sur le filtrage, notre guide sécuriser un VPS Linux avec nftables couvre les règles adaptées à un serveur de jeu.
Panel FiveM, VPS ou serveur dédié : qui réinitialise quoi
La procédure dépend de la façon dont vous choisissez d'héberger FiveM. Un hébergement FiveM avec panel, comme les offres FiveM d'ElypseCloud, est un hébergement mutualisé : plusieurs serveurs de jeu partagent une machine, chacun dans son conteneur, avec un CPU, une RAM et un espace disque SSD fixés par l'offre. Un VPS, ou serveur privé virtuel, repose sur la virtualisation (KVM chez ElypseCloud) : un serveur physique est découpé en plusieurs serveurs virtuels qui ont chacun leur système et leur accès root. Un serveur dédié, ou hébergement dédié, vous donne la machine entière.
| Hébergement FiveM avec panel | Serveur VPS | Serveur dédié | |
|---|---|---|---|
| Réinitialisation | Bouton Reinstall Server (fichiers du jeu) | Réinstallation de l'OS depuis le panneau de contrôle, ou de FXServer à la main | Réinstallation de l'OS, ou de FXServer à la main |
| Accès aux fichiers | Gestionnaire de fichiers et SFTP | SSH et SFTP en root | SSH et SFTP en root |
| Base MySQL | Onglet Databases, phpMyAdmin si fourni | MariaDB à installer | MariaDB à installer |
| Ports et firewall | Port attribué par l'hébergeur | À configurer (ufw, nftables) | À configurer (ufw, nftables) |
| Ressources | CPU, RAM et espace de stockage de l'offre | Ressources réservées sur la machine virtuelle | Toute la machine |
| Système (Debian, Ubuntu) | Géré par l'hébergeur | À votre charge | À votre charge |
Sans infogérance, la reconstruction d'un VPS ou d'un serveur dédié est entièrement de votre ressort : le panel vous épargne cette partie, au prix d'un contrôle moins fin. Ne confondez pas non plus ce panel de jeu avec un panneau de contrôle d'hébergement web comme Plesk : un hébergement web mutualisé sert des sites PHP derrière un serveur web (Apache ou Nginx), il n'est pas prévu pour faire tourner FXServer en continu. Pour choisir entre les deux autres formules, voir notre comparatif VPS ou serveur dédié pour un serveur de jeu, et nos serveurs dédiés pour les grosses communautés.
Reconfigurer le serveur après la réinitialisation
Un serveur fraîchement réinstallé démarre, mais il n'est pas prêt à accueillir des joueurs. Reprenez la configuration dans cet ordre.
1. Le fichier server.cfg. Repartez du fichier recréé plutôt que de recoller l'ancien en entier : ajoutez seulement les lignes dont vous avez besoin.
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "Mon serveur RP"
sv_maxclients 32
set mysql_connection_string "mysql://utilisateur:motdepasse@hote:3306/base"
ensure oxmysql
sv_licenseKey "VOTRE_CLE"
Sur un panel Pterodactyl, ne vous battez pas avec les lignes endpoint_add_tcp, endpoint_add_udp et sv_maxclients : l'egg FiveM les réécrit avec le port attribué à votre serveur et la variable de nombre de joueurs. La clé de licence, elle, se renseigne dans l'onglet Startup, qui la transmet à FXServer au lancement.
2. txAdmin. Avec l'egg courant, txAdmin s'active par une variable de démarrage. Au premier lancement, vous liez votre compte Cfx.re avec le code PIN, créez le mot de passe administrateur, puis déployez une recette (le modèle de serveur par défaut, ou un framework qui demande une base de données). La suite est dans notre guide pour configurer txAdmin sur un serveur FiveM.
3. La base de données. Importez votre fichier .sql dans la nouvelle base, ou le fichier SQL fourni par le framework pour un départ vierge, puis renseignez la chaîne de connexion. Notre guide pour lier une base MySQL à un serveur FiveM détaille les deux formats de mysql_connection_string et les erreurs fréquentes.
4. Les ressources, une par une. Réimportez d'abord les dépendances (oxmysql, ox_lib), puis vos scripts par petits lots, en redémarrant entre chaque lot. C'est le moment d'écarter ce qui vient d'une source douteuse : notre guide scripts FiveM : où les trouver, lesquels éviter aide à faire le tri. Une ressource piégée réimportée telle quelle annule tout le bénéfice de la réinitialisation.
Vérifier que tout est revenu
- La console démarre sans erreur et affiche toutes les ressources attendues.
- Vous vous connectez en jeu avec
connect adresse-ip:portdans la console F8, puis par votre nom de domaine si vous en avez un. Si vous avez changé de machine, et donc d'adresse IP, mettez à jour l'enregistrement DNS : voir configurer un nom de domaine et un enregistrement SRV. - Les personnages, inventaires et véhicules réapparaissent : la base est bien reliée.
- txAdmin est accessible et les comptes administrateurs sont recréés.
- La consommation de RAM et de CPU reste stable pendant les premières heures avec des joueurs connectés.
- Un premier backup du nouvel état est fait, et les sauvegardes suivantes sont planifiées : voir automatiser les sauvegardes d'un serveur FiveM.
Pour tester une nouvelle configuration avant de toucher au serveur de production, l'essai gratuit de 48 h d'un serveur FiveM ElypseCloud, sans carte bancaire, sert de bac à sable. Et si la réinitialisation est l'occasion de tout repenser, notre guide premier serveur FiveM : les 15 questions à se poser vous aide à repartir sur de bonnes bases.
FiveM
Minecraft
Rust
RedM
Hytale