--- title: "Comment mettre à jour son serveur BeamMP ?" description: "Mettez à jour votre serveur BeamMP chez Winheberg vers la dernière version sans perdre vos mods, vos maps ni votre configuration." category: jeux subcategory: beammp icon: tabler:file-text date: 2026-07-24 author: Winheberg slug: "mise-a-jour-serveur-beammp" order: 19 image: /statics/images/docs/fr/gaming/beammp/mise-a-jour-serveur-beammp.webp tags: [beammp, mise à jour, mods, reinstall server] keywords: [mise à jour beammp, serveur beammp winheberg, reinstall server, beammp-server, mods beammp] link_en: "/en/docs/beammp/update-beammp-server" --- ## Contexte Vous gérez un **serveur BeamMP** chez Winheberg et vous voulez le mettre à jour vers une **version plus récente** ? Que ce soit pour profiter de nouvelles fonctionnalités ou pour corriger un bug, la procédure se fait en quelques minutes depuis votre panel gaming. Ce guide vous explique pas à pas comment effectuer cette mise à jour proprement, sans perdre vos **mods**, vos **maps** ou votre **configuration de serveur**. ## Comment savoir si votre serveur a besoin d'une mise à jour ? BeamMP est sympa avec vous. Dès qu'une nouvelle version est disponible, le serveur affiche un **message d'avertissement** dans la console toutes les minutes. Si vous voyez ce type de log se répéter, il est temps de passer à l'action. ``` [23/05/26 23:05:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server! Download it here: https://beammp.com/! For a guide on how to update, visit: https://docs.beammp.com/server/server-maintenance/#updating-the-server [23/05/26 23:06:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server! [23/05/26 23:07:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server! ``` Le message vous indique directement le **numéro de la nouvelle version** disponible (ici `v3.9.3`). Tant que vous ne mettez pas à jour, ce log apparaîtra toutes les minutes dans votre console, ce qui peut vite devenir polluant pour le diagnostic d'autres problèmes. > [!TIP] > Surveillez régulièrement la console de votre serveur. Si vous voyez ce warning, prenez quelques minutes pour suivre la procédure ci-dessous. Ça vous évitera de tourner sur une version dépassée susceptible de contenir des bugs corrigés depuis. ## Prérequis Avant de commencer, assurez-vous d'avoir les éléments suivants. - Un **serveur BeamMP** actif sur votre panel gaming Winheberg - Une **sauvegarde récente** de votre serveur (recommandé en cas de problème post-mise à jour) - Quelques minutes devant vous, idéalement aux heures creuses pour ne pas déranger vos joueurs > [!WARNING] > La procédure nécessite de **supprimer un fichier** et de **réinstaller le serveur**. Vos mods, vos maps et vos configurations seront conservés, mais une sauvegarde reste toujours une bonne précaution avant ce type d'opération. ## Bonne nouvelle, vos mods et maps sont conservés Avant de commencer, rassurez-vous. **La procédure de mise à jour ne supprime pas vos contenus personnalisés**. Le **Reinstall Server** du panel Winheberg ne remplace que le **fichier exécutable** du serveur BeamMP, sans toucher à votre dossier `Resources` qui contient vos mods, ni à vos fichiers de configuration. Vous récupérez donc votre serveur exactement comme avant, juste avec une version plus récente du moteur BeamMP. ## 1. Accéder à votre serveur BeamMP 1. Connectez-vous à votre **panel gaming Winheberg** 2. Sélectionnez votre **serveur BeamMP** 3. **Arrêtez votre serveur** s'il est en cours d'exécution (cliquez sur **Stop**) > [!IMPORTANT] > Le serveur doit impérativement être **arrêté** pour pouvoir supprimer le fichier exécutable. Tenter de le supprimer pendant qu'il tourne ne fonctionnera pas, ou pourra corrompre votre serveur. ## 2. Supprimer le fichier BeamMP-Server Une fois votre serveur arrêté, rendez-vous dans les fichiers de votre serveur. 1. Dans le menu latéral du panel, cliquez sur **Files** 2. À la racine de votre serveur, repérez le fichier nommé **`BeamMP-Server`** (sans extension, car nos serveurs BeamMP tournent sous Linux) 3. Faites un clic droit dessus et sélectionnez **Delete** (ou cochez la case puis cliquez sur Delete) 4. Confirmez la suppression > [!NOTE] > Ne supprimez que ce fichier. Ne touchez pas aux dossiers `Resources`, `Server`, ni aux fichiers `ServerConfig.toml`. Vous garderez ainsi toute votre configuration et vos mods intacts. ## 3. Réinstaller le serveur depuis Settings Une fois le fichier supprimé, retournez à la racine de votre serveur dans le panel. 1. Dans le menu latéral, cliquez sur **Settings** 2. Descendez jusqu'à la section **Reinstall Server** (ou équivalent) 3. Cliquez sur le bouton **Reinstall Server** 4. Confirmez l'opération si une fenêtre vous le demande Le panel va alors **télécharger automatiquement la dernière version** du fichier `BeamMP-Server` et l'installer à la place de l'ancien. > [!TIP] > Cette manipulation ne fait que retélécharger le fichier exécutable depuis les serveurs officiels de BeamMP. Tous vos mods, maps et configurations restent **strictement intacts** dans leurs dossiers respectifs. ## 4. Démarrer votre serveur Une fois l'installation terminée, vous pouvez relancer votre serveur. 1. Retournez sur la page principale de votre serveur dans le panel 2. Cliquez sur **Start** 3. Surveillez la **console** pour vous assurer que le serveur démarre correctement avec la nouvelle version Vous devriez voir dans les logs un message indiquant la nouvelle version de BeamMP en cours d'exécution. ## 5. Vérifier que tout fonctionne Pour confirmer que la mise à jour s'est bien passée. - Connectez-vous au serveur depuis votre client BeamMP **in-game** - Vérifiez que vos **mods** sont bien présents et fonctionnels - Vérifiez que votre **map** se charge correctement - Testez quelques fonctionnalités essentielles (chat, spawn de véhicule, etc.) Si tout fonctionne, votre serveur BeamMP tourne maintenant sur la dernière version 🎉 ## En cas de problème Voici les erreurs les plus fréquentes que vous pourriez rencontrer après une mise à jour. ### ❌ Le serveur ne démarre pas après la réinstallation Consultez la **console** du panel, vous y verrez l'erreur exacte. Les causes les plus fréquentes sont les suivantes. - Un **mod incompatible** avec la nouvelle version de BeamMP, désactivez-le temporairement pour confirmer - Un fichier de **configuration obsolète** (`ServerConfig.toml`), comparez avec un exemple de la nouvelle version pour repérer les options qui auraient changé - Une dépendance manquante côté système, dans ce cas, contactez notre support ### ❌ Le bouton "Reinstall Server" ne fait rien Si le bouton ne déclenche pas la réinstallation, vérifiez les points suivants. - Votre serveur est bien **arrêté**, l'opération ne fonctionne pas serveur en cours d'exécution - Vous avez bien **supprimé** le fichier `BeamMP-Server` au préalable - Rechargez la page du panel et réessayez ### ❌ Mes mods ne fonctionnent plus après la mise à jour Certains mods peuvent ne plus être compatibles avec la nouvelle version de BeamMP. Vérifiez sur la page du mod (ou son forum de référence) s'il existe une **version mise à jour** compatible avec votre nouvelle version de serveur. Sinon, il faudra patienter qu'une mise à jour du mod sorte, ou revenir à une version antérieure de BeamMP. ### ❌ Mes joueurs ne peuvent plus se connecter Une nouvelle version de BeamMP côté serveur peut nécessiter que vos joueurs aient également une version récente de leur **client BeamMP**. Demandez-leur de mettre à jour leur client via le launcher officiel et de relancer le jeu. ## Bonnes pratiques Quelques recommandations pour gérer vos mises à jour BeamMP sereinement. - **Faites une sauvegarde** de votre serveur (mods, configurations, dossier complet) avant chaque mise à jour majeure - **Ne mettez pas à jour en pleine session de jeu** si votre serveur est actif, prévenez vos joueurs et faites-le aux heures creuses - **Suivez l'actualité de BeamMP** ([beammp.com](https://beammp.com/)) pour anticiper les changements importants - **Vérifiez la compatibilité de vos mods** avant la mise à jour si possible, surtout les mods majeurs comme les frameworks de gameplay ou les maps lourdes - **Testez votre serveur** après la mise à jour avec quelques joueurs de confiance avant d'annoncer la reprise officielle ## Besoin d'aide ? Si vous rencontrez un problème lors de la mise à jour de votre serveur BeamMP, ou si votre serveur refuse de démarrer après l'opération, 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 la console. Votre serveur BeamMP est maintenant à jour, profitez des nouveautés et bon jeu 🚗