[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-en-beammp-server-authkey":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":26,"docGroupIcon":26,"link_fr":27,"bodyHtml":28},"\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fbeammp-server-authkey","beammp-server-authkey","How to Set Up Your BeamMP Server AuthKey","Create your AuthKey on the BeamMP Keymaster and enter it in the Winheberg gaming panel so your server shows up on the public server list.","jeux","beammp","tabler:key","2026-11-01","Winheberg",99,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fbeammp-server-authkey.webp",[9,16,17,18],"authkey","keymaster","startup",[20,21,22,23,24,25],"beammp authkey","beammp server key","beammp keymaster","beammp server list","beammp server setup","beamng drive multiplayer","","\u002Fdocs\u002Fbeammp\u002Fauthkey-serveur-beammp","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>You just ordered a \u003Cstrong>BeamMP server\u003C\u002Fstrong> from Winheberg, it starts, yet nobody can find it in the BeamMP launcher&#39;s server list? It is most likely missing its \u003Cstrong>AuthKey\u003C\u002Fstrong>, the authentication key that links your server to your BeamMP account. Without a valid key, your server console shows messages like these.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">[WARN] AuthKey specified is the wrong length and likely isn&#39;t valid.\n[ERROR] Backend REFUSED the auth key. Reason: Your key is invalid. You can generate a key at https:\u002F\u002Fkeymaster.beammp.com\u002F\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The key is created for free on the \u003Cstrong>Keymaster\u003C\u002Fstrong>, the key management area of your BeamMP account, and takes a few seconds to set up from your gaming panel.\u003C\u002Fp>\n\u003Cp>This guide shows you how to \u003Cstrong>create your AuthKey\u003C\u002Fstrong> and \u003Cstrong>set it up on your BeamMP server\u003C\u002Fstrong>.\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\u003C\u002Fli>\n\u003Cli>A \u003Cstrong>BeamMP account\u003C\u002Fstrong>, the one you play with\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-caution\">\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=\"8\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Treat your AuthKey \u003Cstrong>like a password\u003C\u002Fstrong>. Never share it, never show it on stream or in a screenshot. Anyone who gets hold of it can use it on their own server and prevent yours from starting.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Create your key on the Keymaster\u003C\u002Fh2>\n\u003Cp>Go to \u003Ca href=\"https:\u002F\u002Fkeymaster.beammp.com\">keymaster.beammp.com\u003C\u002Fa> and log in with your \u003Cstrong>BeamMP account\u003C\u002Fstrong>. Once in your account area, click the \u003Cstrong>Keymaster\u003C\u002Fstrong> tab at the top of the page.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fbeammp-server-authkey-1793493157068-cd2a68092bd5bf29afb88294.webp\" alt=\"Keymaster tab in the BeamMP account area\" width=\"800\" \u002F>\n\n\u003Cp>The \u003Cstrong>Server Keys\u003C\u002Fstrong> page opens. Click \u003Cstrong>Create New Server Key\u003C\u002Fstrong>. The \u003Cstrong>Your Server Keys\u003C\u002Fstrong> block at the bottom left shows how many keys of your quota are in use.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fbeammp-server-authkey-1793493242871-6e126f47a9e994c3b0b28df4.webp\" alt=\"Create New Server Key button on the Server Keys page\" width=\"800\" \u002F>\n\n\u003Cp>Confirm by clicking \u003Cstrong>Create Key\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fbeammp-server-authkey-1793493157440-52634d0dd22d8225bbe26eb4.webp\" alt=\"Create New Server Key confirmation window\" width=\"435\" \u002F>\n\n\u003Cp>Your new key shows up under \u003Cstrong>Your Server Keys\u003C\u002Fstrong>. Click \u003Cstrong>Show Keys\u003C\u002Fstrong> if it is hidden, then click the copy icon to put it in your clipboard. The button right next to it regenerates the key.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fbeammp-server-authkey-1793493157949-e1632821062d78b7bf039137.webp\" alt=\"Copy button of the BeamMP server key\" width=\"426\" \u002F>\n\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>Already had keys on the old Discord-based Keymaster? The \u003Cstrong>Legacy Keys\u003C\u002Fstrong> block on the same page lets you bring them across with the \u003Cstrong>Link Discord\u003C\u002Fstrong> button.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Enter the key in the panel\u003C\u002Fh2>\n\u003Cp>On the Winheberg gaming panel, BeamMP&#39;s main settings live on the \u003Cstrong>Startup\u003C\u002Fstrong> page, just like the map.\u003C\u002Fp>\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>In the side menu, click \u003Cstrong>Startup\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Paste your key into the \u003Cstrong>Authentication Key\u003C\u002Fstrong> field\u003C\u002Fli>\n\u003Cli>Leave the \u003Cstrong>Private\u003C\u002Fstrong> switch on \u003Cstrong>False\u003C\u002Fstrong> if you want your server to appear on the public list\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fbeammp-server-authkey-1793493756515-89b3614762573abf5c88a61f.webp\" alt=\"Authentication Key and Private fields on the Startup page\" width=\"800\" \u002F>\n\n\u003Cp>While you are there, set the name and description shown on the list with the \u003Cstrong>Server Name\u003C\u002Fstrong> and \u003Cstrong>Server Description\u003C\u002Fstrong> fields on the same page.\u003C\u002Fp>\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>Enter the key on the \u003Cstrong>Startup\u003C\u002Fstrong> page, not directly in \u003Ccode>ServerConfig.toml\u003C\u002Fcode>. On every start, the panel rewrites the \u003Ccode>AuthKey\u003C\u002Fcode>, \u003Ccode>Private\u003C\u002Fcode>, \u003Ccode>Name\u003C\u002Fcode>, \u003Ccode>Description\u003C\u002Fcode> and \u003Ccode>Map\u003C\u002Fcode> lines of that file with the values from the Startup page. A key pasted only into the file would be wiped on the next start.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Restart and check\u003C\u002Fh2>\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> during startup and make sure the \u003Ccode>Backend REFUSED the auth key\u003C\u002Fcode> line no longer shows up\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Once the server is running, it appears in the \u003Cstrong>Your Online Servers\u003C\u002Fstrong> block of the Server Keys page, which confirms the key is accepted. It can then take a few minutes to show up on the BeamMP launcher&#39;s list.\u003C\u002Fp>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Cp>Here are the most common situations after setting up the AuthKey.\u003C\u002Fp>\n\u003Ch3>❌ The console shows Backend REFUSED the auth key\u003C\u002Fh3>\n\u003Cp>BeamMP does not recognise the key you entered.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Make sure you copied the \u003Cstrong>full\u003C\u002Fstrong> key with the Keymaster&#39;s copy icon, not the shortened version shown on screen\u003C\u002Fli>\n\u003Cli>Check that the key has \u003Cstrong>no spaces\u003C\u002Fstrong> before or after it, copy and paste can add some\u003C\u002Fli>\n\u003Cli>If you regenerated the key on the Keymaster, the old one no longer works, paste the new one on the Startup page\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The server still does not appear on the list\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check that the \u003Cstrong>Private\u003C\u002Fstrong> switch on the Startup page is set to \u003Cstrong>False\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Wait a few minutes after the restart, the public list is not instant\u003C\u002Fli>\n\u003Cli>Reload the Startup page to confirm the key was saved\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The same key is used somewhere else\u003C\u002Fh3>\n\u003Cp>An AuthKey can only be used \u003Cstrong>on one server at a time\u003C\u002Fstrong>. If the same key is already running on another server (an old server, a test server on your PC, etc.), stop it or create a new dedicated key on the Keymaster. The \u003Cstrong>Your Online Servers\u003C\u002Fstrong> block shows where your keys are in use.\u003C\u002Fp>\n\u003Ch3>❌ My change to ServerConfig.toml disappears on restart\u003C\u002Fh3>\n\u003Cp>This is expected, the panel rewrites that file on every start with the values from the \u003Cstrong>Startup\u003C\u002Fstrong> page. Go back to step 2 of this guide.\u003C\u002Fp>\n\u003Ch3>❌ I cannot create a new key\u003C\u002Fh3>\n\u003Cp>The Keymaster grants a \u003Cstrong>limited number of keys\u003C\u002Fstrong> per account, shown under \u003Cstrong>Your Server Keys\u003C\u002Fstrong>. Reuse a key you no longer need, or check BeamMP&#39;s official FAQ, which explains how to get more by supporting the project.\u003C\u002Fp>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>One key per server\u003C\u002Fstrong>, even for a test server, so they never block each other\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Regenerate your key\u003C\u002Fstrong> with the Keymaster&#39;s dedicated button if you think it has leaked, then replace it on the Startup page\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Limit your sub-users&#39; permissions\u003C\u002Fstrong> on the panel, the Startup page shows the key in plain text\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Keep an AuthKey even on a private server\u003C\u002Fstrong>, as BeamMP officially recommends\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If your server stays invisible despite a valid key, 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. Never paste your AuthKey into the ticket, we do not need it.\u003C\u002Fp>\n\u003Cp>Your BeamMP server is now visible to everyone, enjoy the ride 🛣️\u003C\u002Fp>\n",1794526351647]