How to Get a BeamMP Auth Key for Your Server
How to generate and configure a BeamMP authentication key — what it does, how Keymaster works, key limits, and common errors.
Every BeamMP server requires an Auth Key to function. The key links your server to your BeamMP account via the Keymaster dashboard. Without a valid key, the server process starts but refuses connections and won't register with the BeamMP backend.
What the Auth Key Does
The Auth Key authenticates your server with BeamMP's master server infrastructure. When your server starts, it sends the key to BeamMP's backend. If valid, the backend:
- Registers the server for the public browser (if
Private = false) - Enables player connections via the BeamMP client
- Associates your server with your Discord-linked BeamMP account
If the key is missing, invalid, or already in use on another instance, the backend rejects the server and no players can connect.
Generating a Key
Log in to Keymaster
Open beammp.com/keymaster and authenticate with your Discord account. This is the only login method — BeamMP doesn't have its own account system.
Create a new key
Click Keys in the sidebar, then the green + button. Enter a label to identify this key (e.g., "XGaming Server 1"). The label is just for your reference — it's not shown to players.
Copy the key
The key appears once. Copy it immediately — you can view it again later from the Keys page, but it's easier to copy now.
Adding the Key to Your Server
Via the Panel (Recommended)
- Log in to the XGamingServer Panel
- Select your BeamMP server
- Click Startup in the sidebar
- Find the Auth Key field
- Paste your key
- Restart your server from Console
Key Limits & Rules
| Rule | Detail |
|---|---|
| One key per server | A key can only be active on one server process at a time. Starting a second server with the same key disconnects the first. |
| Keys per account | Each Discord account has a limited number of keys (typically 2–5 depending on account age/status) |
| Key sharing | Never share your key. Anyone with it can run a server under your identity — and any violations (ToS, abuse) are tied to YOUR account. |
| Revoking a key | Delete it on the Keymaster page. The server using it immediately loses backend access. |
| Expired/inactive keys | Keys don't expire by time, but can be invalidated if BeamMP detects abuse or your Discord account is banned. |
Troubleshooting Auth Key Errors
| Console Message | Cause | Fix |
|---|---|---|
No AuthKey Specified | The AuthKey field in config is empty | Paste your key in Startup or ServerConfig.toml |
Backend system refused server! Check your AuthKey | Key is invalid, revoked, or already running on another server | Check Keymaster — is the key still there? Is another server using it? Generate a new one if needed. |
[WARN] Backend failed to respond to a heartbeat | BeamMP backend is temporarily unreachable (maintenance or outage) | Wait 5–10 minutes and restart. Check BeamMP Discord for status updates. |
| Server starts but nobody can connect | Key might be valid but Private = true | Set Private = false in config if you want browser listing |
Related Guides
How is this guide?
