[{"data":1,"prerenderedAt":27},["ShallowReactive",2],{"doc-en-update-beammp-server":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":19,"docGroup":24,"docGroupIcon":24,"link_fr":25,"bodyHtml":26},"\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fupdate-beammp-server","update-beammp-server","How to update your BeamMP server","Update your BeamMP server at Winheberg to the latest version without losing your mods, maps, or configuration.","jeux","beammp","tabler:file-text","2026-07-24","Winheberg",19,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fupdate-beammp-server.webp",[9,16,17,18],"update","mods","reinstall server",[20,21,18,22,23],"update beammp server","beammp server winheberg","beammp-server","beammp mods","","\u002Fdocs\u002Fbeammp\u002Fmise-a-jour-serveur-beammp","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>You manage a \u003Cstrong>BeamMP server\u003C\u002Fstrong> at Winheberg and want to update it to a \u003Cstrong>newer version\u003C\u002Fstrong>? Whether it's to enjoy new features or fix a bug, the process takes just a few minutes from your gaming panel.\u003C\u002Fp>\n\u003Cp>This guide walks you through the update step by step, without losing your \u003Cstrong>mods\u003C\u002Fstrong>, your \u003Cstrong>maps\u003C\u002Fstrong>, or your \u003Cstrong>server configuration\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2>How do you know if your server needs an update?\u003C\u002Fh2>\n\u003Cp>BeamMP is nice about it. As soon as a new version is available, the server displays a \u003Cstrong>warning message\u003C\u002Fstrong> in the console every minute. If you see this kind of log repeating, it's time to act.\u003C\u002Fp>\n\u003Cpre>\u003Ccode>[23\u002F05\u002F26 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:\u002F\u002Fbeammp.com\u002F! For a guide on how to update, visit: https:\u002F\u002Fdocs.beammp.com\u002Fserver\u002Fserver-maintenance\u002F#updating-the-server\n[23\u002F05\u002F26 23:06:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server!\n[23\u002F05\u002F26 23:07:57] [WARN] NEW VERSION IS OUT! Please update to the new version (v3.9.3) of the BeamMP-Server!\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The message tells you directly the \u003Cstrong>number of the new version\u003C\u002Fstrong> available (here \u003Ccode>v3.9.3\u003C\u002Fcode>). As long as you don't update, this log will show up every minute in your console, which can quickly get in the way when diagnosing other issues.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Keep an eye on your server's console regularly. If you see this warning, take a few minutes to follow the procedure below. It'll save you from running an outdated version that may contain bugs already fixed since.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cp>Before you start, make sure you have the following.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>An active \u003Cstrong>BeamMP server\u003C\u002Fstrong> on your Winheberg gaming panel\u003C\u002Fli>\n\u003Cli>A \u003Cstrong>recent backup\u003C\u002Fstrong> of your server (recommended in case of an issue after the update)\u003C\u002Fli>\n\u003Cli>A few spare minutes, ideally during off-peak hours so as not to disturb your players\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The process requires \u003Cstrong>deleting a file\u003C\u002Fstrong> and \u003Cstrong>reinstalling the server\u003C\u002Fstrong>. Your mods, maps, and configuration will be kept, but a backup is always a good precaution before this kind of operation.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Good news, your mods and maps are kept\u003C\u002Fh2>\n\u003Cp>Before you start, rest assured. \u003Cstrong>The update process doesn't delete your custom content\u003C\u002Fstrong>. The \u003Cstrong>Reinstall Server\u003C\u002Fstrong> option in the Winheberg panel only replaces the BeamMP server's \u003Cstrong>executable file\u003C\u002Fstrong>, without touching your \u003Ccode>Resources\u003C\u002Fcode> folder, which holds your mods, or your configuration files.\u003C\u002Fp>\n\u003Cp>You get your server back exactly as before, just with a newer version of the BeamMP engine.\u003C\u002Fp>\n\u003Ch2>1. Access your BeamMP server\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Log in to your \u003Cstrong>Winheberg gaming panel\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Select your \u003Cstrong>BeamMP server\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Stop your server\u003C\u002Fstrong> if it's currently running (click \u003Cstrong>Stop\u003C\u002Fstrong>)\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The server must be \u003Cstrong>stopped\u003C\u002Fstrong> for the executable file to be deleted. Trying to delete it while it's running won't work, and could corrupt your server.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Delete the BeamMP-Server file\u003C\u002Fh2>\n\u003Cp>Once your server is stopped, go to your server's files.\u003C\u002Fp>\n\u003Col>\n\u003Cli>In the panel's side menu, click \u003Cstrong>Files\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>At the root of your server, find the file named \u003Cstrong>\u003Ccode>BeamMP-Server\u003C\u002Fcode>\u003C\u002Fstrong> (no extension, since our BeamMP servers run on Linux)\u003C\u002Fli>\n\u003Cli>Right-click it and select \u003Cstrong>Delete\u003C\u002Fstrong> (or check the box and click Delete)\u003C\u002Fli>\n\u003Cli>Confirm the deletion\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Only delete this file. Don't touch the \u003Ccode>Resources\u003C\u002Fcode> or \u003Ccode>Server\u003C\u002Fcode> folders, or the \u003Ccode>ServerConfig.toml\u003C\u002Fcode> file. This way you'll keep all your configuration and mods intact.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Reinstall the server from Settings\u003C\u002Fh2>\n\u003Cp>Once the file is deleted, go back to your server's root page in the panel.\u003C\u002Fp>\n\u003Col>\n\u003Cli>In the side menu, click \u003Cstrong>Settings\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Scroll down to the \u003Cstrong>Reinstall Server\u003C\u002Fstrong> section (or equivalent)\u003C\u002Fli>\n\u003Cli>Click the \u003Cstrong>Reinstall Server\u003C\u002Fstrong> button\u003C\u002Fli>\n\u003Cli>Confirm the operation if a window asks you to\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>The panel will then \u003Cstrong>automatically download the latest version\u003C\u002Fstrong> of the \u003Ccode>BeamMP-Server\u003C\u002Fcode> file and install it in place of the old one.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>This operation only redownloads the executable file from BeamMP's official servers. All your mods, maps, and configurations stay \u003Cstrong>strictly intact\u003C\u002Fstrong> in their respective folders.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Start your server\u003C\u002Fh2>\n\u003Cp>Once the installation is done, you can restart your server.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Go back to your server's main page in the panel\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Start\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Watch the \u003Cstrong>console\u003C\u002Fstrong> to make sure the server starts correctly with the new version\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>You should see a log message in the console indicating the new BeamMP version running.\u003C\u002Fp>\n\u003Ch2>5. Check that everything works\u003C\u002Fh2>\n\u003Cp>To confirm the update went well.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Connect to the server from your BeamMP client \u003Cstrong>in-game\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Check that your \u003Cstrong>mods\u003C\u002Fstrong> are present and working\u003C\u002Fli>\n\u003Cli>Check that your \u003Cstrong>map\u003C\u002Fstrong> loads correctly\u003C\u002Fli>\n\u003Cli>Test a few essential features (chat, vehicle spawning, etc.)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>If everything works, your BeamMP server is now running the latest version 🎉\u003C\u002Fp>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Cp>Here are the most common errors you might run into after an update.\u003C\u002Fp>\n\u003Ch3>❌ The server doesn't start after reinstalling\u003C\u002Fh3>\n\u003Cp>Check the panel's \u003Cstrong>console\u003C\u002Fstrong>, you'll see the exact error there. The most common causes are the following.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>An \u003Cstrong>incompatible mod\u003C\u002Fstrong> with the new BeamMP version, disable it temporarily to confirm\u003C\u002Fli>\n\u003Cli>An \u003Cstrong>outdated configuration file\u003C\u002Fstrong> (\u003Ccode>ServerConfig.toml\u003C\u002Fcode>), compare it with an example from the new version to spot options that may have changed\u003C\u002Fli>\n\u003Cli>A missing dependency on the system side, in that case, contact our support\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The "Reinstall Server" button doesn't do anything\u003C\u002Fh3>\n\u003Cp>If the button doesn't trigger the reinstall, check the following.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Your server is \u003Cstrong>stopped\u003C\u002Fstrong>, the operation doesn't work while the server is running\u003C\u002Fli>\n\u003Cli>You did \u003Cstrong>delete\u003C\u002Fstrong> the \u003Ccode>BeamMP-Server\u003C\u002Fcode> file beforehand\u003C\u002Fli>\n\u003Cli>Reload the panel page and try again\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ My mods stopped working after the update\u003C\u002Fh3>\n\u003Cp>Some mods may no longer be compatible with the new BeamMP version. Check the mod's page (or its reference forum) to see if there's an \u003Cstrong>updated version\u003C\u002Fstrong> compatible with your new server version. Otherwise, you'll need to wait for a mod update, or roll back to an earlier BeamMP version.\u003C\u002Fp>\n\u003Ch3>❌ My players can't connect anymore\u003C\u002Fh3>\n\u003Cp>A new server-side BeamMP version may require your players to also have a recent version of their \u003Cstrong>BeamMP client\u003C\u002Fstrong>. Ask them to update their client through the official launcher and relaunch the game.\u003C\u002Fp>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cp>A few recommendations for handling your BeamMP updates smoothly.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Make a backup\u003C\u002Fstrong> of your server (mods, configurations, full folder) before every major update\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Don't update during an active gaming session\u003C\u002Fstrong>, warn your players and do it during off-peak hours\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Follow BeamMP's news\u003C\u002Fstrong> (\u003Ca href=\"https:\u002F\u002Fbeammp.com\u002F\">beammp.com\u003C\u002Fa>) to anticipate important changes\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Check your mods' compatibility\u003C\u002Fstrong> before updating if possible, especially major mods like gameplay frameworks or heavy maps\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Test your server\u003C\u002Fstrong> after the update with a few trusted players before announcing the official restart\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If you run into an issue while updating your BeamMP server, or if your server refuses to start after the operation, our team is here. Open a ticket in the \u003Cstrong>Technical\u003C\u002Fstrong> department from your client area, fill in the \u003Cstrong>Produit lié\u003C\u002Fstrong> field with the server in question, and attach the console startup logs.\u003C\u002Fp>\n\u003Cp>Your BeamMP server is now up to date, enjoy the new features and happy gaming 🚗\u003C\u002Fp>\n",1788993140657]