[{"data":1,"prerenderedAt":30},["ShallowReactive",2],{"doc-en-configure-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":27,"docGroupIcon":27,"link_fr":28,"bodyHtml":29},"\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fconfigure-beammp-server","configure-beammp-server","How to Configure Your BeamMP Server (Name, Players, Tags)","Set the name, description, player and car limits and tags of your BeamMP server at Winheberg, between the Startup page and ServerConfig.toml.","jeux","beammp","tabler:settings","2026-11-01","Winheberg",102,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fconfigure-beammp-server.webp",[9,16,17,18],"configuration","startup","serverconfig",[20,21,22,23,24,25,26],"configure beammp server","serverconfig.toml","beammp server name","beammp max players","beammp tags","beammp startup","beammp hosting","","\u002Fdocs\u002Fbeammp\u002Fconfigurer-serveur-beammp","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>Want to name your \u003Cstrong>BeamMP server\u003C\u002Fstrong> at Winheberg, host more players, allow several cars per person or add tags so players find you more easily on the list? All of these settings live in two places, the panel&#39;s \u003Cstrong>Startup\u003C\u002Fstrong> page and the \u003Ccode>ServerConfig.toml\u003C\u002Fcode> file.\u003C\u002Fp>\n\u003Cp>Knowing which one to use for each setting avoids the most common surprise, a change that disappears on restart. This guide explains where to set each option and why.\u003C\u002Fp>\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, available on our \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fgaming\u002Fbeammp\">\u003Cstrong>gaming\u002Fbeammp\u003C\u002Fstrong>\u003C\u002Fa> page\u003C\u002Fli>\n\u003Cli>A few minutes to change the settings and restart the server\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Startup or ServerConfig.toml, which does what?\u003C\u002Fh2>\n\u003Cp>On every start, the panel rewrites some lines of \u003Ccode>ServerConfig.toml\u003C\u002Fcode> with the values from the \u003Cstrong>Startup\u003C\u002Fstrong> page. The other lines of the file stay exactly as you left them.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Setting\u003C\u002Fth>\n\u003Cth>Where to change it\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Name, description, player count, car count\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Startup\u003C\u002Fstrong> page\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Map, private mode, AuthKey, chat logging\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Startup\u003C\u002Fstrong> page\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Tags, guests, debug mode\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>ServerConfig.toml\u003C\u002Fcode> file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Port\u003C\u002Ftd>\n\u003Ctd>Do not change it, the panel assigns it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\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>If you change a setting managed by the Startup page inside \u003Ccode>ServerConfig.toml\u003C\u002Fcode>, your change will be \u003Cstrong>overwritten on the next start\u003C\u002Fstrong>. For those settings, always use Startup.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Set the name, players and cars in Startup\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Log in to your \u003Cstrong>Winheberg gaming panel\u003C\u002Fstrong> and select your \u003Cstrong>BeamMP server\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>In the side menu, click \u003Cstrong>Startup\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Change the fields you need in the \u003Cstrong>Variables\u003C\u002Fstrong> section\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Changes are \u003Cstrong>saved automatically\u003C\u002Fstrong> as you type, no save button is needed.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fconfigure-beammp-server-1793495465986-61bf03281aec90ba92cec87c.webp\" alt=\"Server Name and Max Players fields on the Startup page\" width=\"800\" \u002F>\n\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fconfigure-beammp-server-1793495604664-4b785d3da4e5ee4800bee953.webp\" alt=\"Max Cars and Server Description fields on the Startup page\" width=\"800\" \u002F>\n\n\u003Cp>Here is what each field does.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Purpose\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Server Name\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Name shown on the BeamMP server list\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Server Description\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Description shown under the name\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Max Players\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Maximum number of players connected at the same time\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Max Cars\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Maximum number of cars a single player can spawn\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>BeamMP Server Version\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Server version to install, \u003Ccode>latest\u003C\u002Fcode> by default\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>The \u003Cstrong>Map\u003C\u002Fstrong>, \u003Cstrong>Private\u003C\u002Fstrong> and \u003Cstrong>Authentication Key\u003C\u002Fstrong> fields on the same page each have their own guide, \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fbeammp\u002Fchange-official-map-beammp\">\u003Cstrong>&quot;How to Change Your BeamMP Server&#39;s Official Map&quot;\u003C\u002Fstrong>\u003C\u002Fa>, \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fbeammp\u002Fprivate-beammp-server\">\u003Cstrong>&quot;How to Make Your BeamMP Server Private&quot;\u003C\u002Fstrong>\u003C\u002Fa> and \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fbeammp\u002Fbeammp-server-authkey\">\u003Cstrong>&quot;How to Set Up Your BeamMP Server AuthKey&quot;\u003C\u002Fstrong>\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2>2. Add tags in ServerConfig.toml\u003C\u002Fh2>\n\u003Cp>Tags help players find your server by play style. They are not managed by the Startup page, you set them directly in the file.\u003C\u002Fp>\n\u003Col>\n\u003Cli>In the side menu, click \u003Cstrong>Files\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Open the \u003Cstrong>\u003Ccode>ServerConfig.toml\u003C\u002Fcode>\u003C\u002Fstrong> file at the root of the server\u003C\u002Fli>\n\u003Cli>Find the \u003Ccode>Tags\u003C\u002Fcode> line and enter your tags separated by commas, without spaces\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Save Content\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cpre>\u003Ccode class=\"language-toml\">Tags = &quot;Freeroam,Racing,Francophone&quot;\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fconfigure-beammp-server-1793495605050-9bbc85e0b1b0cd8e27ff0021.webp\" alt=\"Tags and AllowGuests lines in ServerConfig.toml and Save Content button\" width=\"770\" \u002F>\n\n\u003Cp>The same file holds other settings that are kept across restarts.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Line\u003C\u002Fth>\n\u003Cth>Purpose\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>AllowGuests\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>true\u003C\u002Fcode> lets players join as guests, without a BeamMP account, \u003Ccode>false\u003C\u002Fcode> refuses them\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Debug\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>true\u003C\u002Fcode> prints detailed messages in the console, handy to diagnose a problem\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>InformationPacket\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Lets players see the server information before joining\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\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>If you restrict your server to a whitelist, set \u003Ccode>AllowGuests\u003C\u002Fcode> to \u003Ccode>false\u003C\u002Fcode> so a guest cannot pose as another player. Setting up the whitelist is covered in our guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fbeammp\u002Fmoderate-beammp-server\">\u003Cstrong>&quot;How to Moderate Your BeamMP Server (Kick, Ban, Whitelist)&quot;\u003C\u002Fstrong>\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\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>Do not change the \u003Ccode>Port\u003C\u002Fcode> line. It matches the port the panel assigned to your server and it is rewritten on every start.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Restart the server\u003C\u002Fh2>\n\u003Cp>All these settings are only applied when the server starts.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Go back to your server&#39;s main page\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Restart\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Watch the \u003Cstrong>console\u003C\u002Fstrong>, the \u003Ccode>Vehicle data network online on port ... with a Max of ... Clients\u003C\u002Fcode> line confirms the player count in use\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Cp>Here are the most common situations when configuring the server.\u003C\u002Fp>\n\u003Ch3>❌ My change disappears on restart\u003C\u002Fh3>\n\u003Cp>You most likely changed a setting managed by the Startup page (name, description, players, cars, map, private mode or AuthKey) inside \u003Ccode>ServerConfig.toml\u003C\u002Fcode>. Make the change again from \u003Cstrong>Startup\u003C\u002Fstrong>, then restart.\u003C\u002Fp>\n\u003Ch3>❌ The new name does not show up on the list\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check that the server actually \u003Cstrong>restarted\u003C\u002Fstrong> after the change\u003C\u002Fli>\n\u003Cli>Check that the server has a \u003Cstrong>valid AuthKey\u003C\u002Fstrong> and that the \u003Cstrong>Private\u003C\u002Fstrong> switch is on \u003Cstrong>False\u003C\u002Fstrong>, otherwise it does not appear on the public list\u003C\u002Fli>\n\u003Cli>Wait a few minutes, the public list is not instant\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ My tags are not applied\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check that you clicked \u003Cstrong>Save Content\u003C\u002Fstrong> before closing the file\u003C\u002Fli>\n\u003Cli>Check the format, tags must be in quotes and separated by commas (\u003Ccode>&quot;Freeroam,Racing&quot;\u003C\u002Fcode>)\u003C\u002Fli>\n\u003Cli>Restart the server after the change\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Pick a short, readable name\u003C\u002Fstrong>, it is shown in a list alongside many other servers\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Raise Max Cars with care\u003C\u002Fstrong>, each extra car adds load for the server and for players\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Add tags that really describe your server\u003C\u002Fstrong>, players use them to filter the list\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Write down your settings\u003C\u002Fstrong> before reinstalling the server, so you can put them back quickly\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If a setting does not apply despite these checks, our team is here to help. Open a ticket with the \u003Cstrong>Technical\u003C\u002Fstrong> department from your client area, fill in the \u003Cstrong>Related Product\u003C\u002Fstrong> field with the server concerned and attach the startup logs.\u003C\u002Fp>\n\u003Cp>Your BeamMP server is set up your way, enjoy the ride 🛣️\u003C\u002Fp>\n",1794526351744]