BeamMP ServerConfig.toml and AuthKey Setup Explained
A BeamMP server needs two things before it will start: an AuthKey from keymaster.beammp.com, and that key entered in your server. On ChicagoServers that is the BeamMP AuthKey field on the Startup tab; it is the same value as the AuthKey setting in ServerConfig.toml. Everything else has a working default, but one default catches almost everyone: the game's own Private setting is true, so a server that keeps it stays out of the public server list.
This guide covers the key, then every setting the current server writes to ServerConfig.toml, with defaults read from the BeamMP-Server v3.9.3 source and the official BeamMP docs (checked 2026-11-01), and says which ones have a field on the panel's Startup tab. Server updates can add or rename settings, so compare against the file on your server's Configs tab.
- Log in to Keymaster with Discord, open Keys, click the green + button, name the key, click Create, then copy it. Treat it like a password.
- In the panel, open your server, then the Startup tab. Paste the key into BeamMP AuthKey, click Save startup, then Restart.
- The game's default is
Private = true, which hides the server from the list. For a public server turn off the Private field on the Startup tab. - Game defaults in v3.9.3: Port 30814 (TCP and UDP), MaxPlayers 8, MaxCars 1, Map
/levels/gridmap_v2/info.json. On ChicagoServers the panel assigns the port and your plan sets the player slots. - The server reads
ServerConfig.tomlonly at startup. On the Configs tab, edit, click Save, then Restart.
On this page
How to get a BeamMP AuthKey from Keymaster
The AuthKey is what identifies your server to the BeamMP backend. You create it on Keymaster, which uses your Discord login.
- Log in to Keymaster
Open keymaster.beammp.com and sign in with Discord.
- Open Keys and add one
Click Keys in the left sidebar, then the green + button in the top right.
- Name the key
The name is only a label so you can tell your keys apart. It is not the server name players see in the list.
- Create and copy it
Click Create, then use the clipboard icon to the right of the key to copy it.
- Enter it in the panel
Open your server at panel.chicagoservers.co, go to the Startup tab, paste the key into BeamMP AuthKey, click Save startup, then click Restart at the top of the page.
A valid key is 36 characters long (the pattern is groups of letters and numbers separated by dashes). If yours is a different length the server logs a warning that it is probably not valid, which usually means the key was copied with a missing or extra character.
Editing ServerConfig.toml on a ChicagoServers server
You do not write the file from scratch or run anything yourself. The server creates ServerConfig.toml (plus Server.log and a Resources folder) on its first start, and the panel edits it for you.
- Open the Configs tab
Open your server in the panel, then the Configs tab, and pick ServerConfig.toml from the list. If the file does not exist yet the tab says so; saving creates it.
- Edit it
Use the Settings view for the common settings, or switch to Text to edit the whole file.
- Save and restart
Click Save, then Restart at the top of the page. Changes apply when the server next starts.
On the first start without a key the console tells you to get an AuthKey and restart. That is expected: enter the key in BeamMP AuthKey on the Startup tab and start again. You can also open the file on the Files tab or over SFTP.
The server reads the file at startup and writes it back with the values it loaded, so any hand-written comments are not preserved. Settings the panel controls (the name, ports and player slots, plus the values that have a Startup field) are written from the Startup tab and your plan at every start, so editing them in the file does not stick. The old Server.cfg format is obsolete and not compatible; if one is still present the server warns about it.
ServerConfig.toml settings explained
Everything below sits under the [General] header unless noted. Defaults are the values in the v3.9.3 server source. The last column says where to change each one on the panel: settings with a Startup field are changed there (then Save startup and Restart), the rest in ServerConfig.toml on the Configs tab.
| Setting | What it does | Default | On ChicagoServers |
|---|---|---|---|
AuthKey | Your Keymaster key. The server will not start without it. | empty | BeamMP AuthKey on the Startup tab |
Name | Server name shown in the list. Supports formatting codes. The backend limit is 250 characters. | BeamMP Server | Server name on the Startup tab |
Description | Text shown in the list for public servers. Supports formatting codes. Limit 1000 characters. | BeamMP Default Description | Description on the Startup tab |
Tags | Comma-separated tags to help players find you, such as Freeroam,Modded,Racing. Use tags from BeamMP's approved tag list. Not case sensitive. Limit 100 characters. | Freeroam | Tags on the Startup tab |
Port | Port the server listens on. Any value from 1024 to 65535 that nothing else on the machine uses. | 30814 | Assigned by the panel (Startup tab, Network). Do not change it |
IP | Local address to bind to. Leave it alone unless you know why you are changing it. | :: | Leave it alone |
MaxPlayers | Player slots. Does not limit vehicles. | 8 | Set by your plan |
MaxCars | Vehicles per player. Extra spawns are deleted immediately. | 1 | Cars per player on the Startup tab |
Map | Level path, for example /levels/gridmap_v2/info.json. Must be a stock map or a map installed as a server mod. Limit 100 characters. | /levels/gridmap_v2/info.json | Map on the Startup tab; Map from a mod for a custom map |
Private | true keeps the server out of the public list. Players who know the IP and port can still join. | true | Private on the Startup tab |
AllowGuests | Whether players who are not logged in to a BeamMP account may join. | true | Configs tab |
InformationPacket | Lets clients that are not connected fetch your public server info directly from the server. | true | Configs tab |
LogChat | Writes chat messages to the log. The sample in the BeamMP setup guide shows false, but the v3.9.3 source default is true. | true | Configs tab |
Debug | Verbose logging. Greatly increases log size, so leave it off unless you are chasing a problem. | false | Configs tab |
ResourceFolder | Where the Resources folder lives, so you can keep it away from the server files. | Resources | Leave it at the default on a hosted server |
ImScaredOfUpdates (under [Misc]) | Controls the periodic update reminder in the console. An update notice always appears at startup. | true | Configs tab |
UpdateReminderTime (under [Misc]) | How often the update reminder repeats, for example 30s, 10min, 2h or 1d. | 30s | Configs tab |
The v3.9.3 server writes back only the settings listed above, so extra sections or keys added by hand are removed the next time it starts.
A working public server config
This is a typical public freeroam setup, shown as a reference for the file layout. The AuthKey is a placeholder. On ChicagoServers, AuthKey, Name, Description, Tags, Port, MaxPlayers, MaxCars, Map and Private come from the Startup tab and your plan at every start, so set those there and use the Configs tab for the rest.
[General]
AuthKey = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Name = "My BeamMP Server"
Description = "Freeroam, friendly drivers, no ramming."
Tags = "Freeroam,Modded"
Port = 30814
MaxPlayers = 16
MaxCars = 2
Map = "/levels/gridmap_v2/info.json"
Private = false
AllowGuests = true
Debug = falseRaise the cars per player and the player slots gradually. Total vehicle count is what players and the server actually feel, so 16 players with 2 cars each is a much heavier session than 16 players with 1 car each.
Ports and why the server is not in the list
BeamMP needs both TCP and UDP on its port (30814 by default). On ChicagoServers you do not forward or open anything: the panel assigns the port, and the address to copy is at the top of the server's page and on the Startup tab under Network. That is the main reason many communities use BeamMP server hosting instead of forwarding ports at home.
If the server starts but nobody can find or join it, work through these in order:
- Not in the list at all: check the Private field on the Startup tab. The game's default is true.
- Startup error about the AuthKey: the key is empty or malformed. Re-copy it from Keymaster into BeamMP AuthKey, then Save startup and Restart.
- Error 10048 or 10022: something else is already using the port. The panel assigns the port, so this should not happen; do not edit
Portin the file, contact support instead. - Errors 10060, 10061 or 10065 for joining players: the port is not reachable. Check that the server is running, that players use the address from the top of the server's page, and read the Troubleshoot tab. If it still fails, contact support.
- You can see the server but cannot join: read the last lines on the Console tab and check that players' game and BeamMP versions match the server's.
Also scan the Console tab and Server.log for [ERROR] and [WARN] lines after every start; the official docs recommend this as the first check.
Overriding settings with environment variables
Since server v3.2.0 each setting can be overridden by an environment variable with a BEAMMP_ prefix, which is useful for containers. The documented names are BEAMMP_AUTH_KEY, BEAMMP_NAME, BEAMMP_DESCRIPTION, BEAMMP_TAGS, BEAMMP_PORT, BEAMMP_MAX_PLAYERS, BEAMMP_MAX_CARS, BEAMMP_MAP, BEAMMP_PRIVATE, BEAMMP_DEBUG, BEAMMP_LOG_CHAT and BEAMMP_RESOURCE_FOLDER. The v3.9.3 source also reads BEAMMP_ALLOW_GUESTS, BEAMMP_INFORMATION_PACKET and BEAMMP_IP. Booleans are on for true or 1 and off for anything else.
This is for people who run their own machine or container. On ChicagoServers use the Startup and Configs tabs instead. If an edit to ServerConfig.toml seems to be ignored, the usual cause on the panel is that the setting has a Startup field, which is written to the file at every start. On a machine you run yourself, an environment variable also wins over the file.
Frequently asked questions
Why is my BeamMP server not showing in the server list?
The most common cause is the Private setting, which is true by default in the game. Turn off <strong>Private</strong> on the <strong>Startup</strong> tab, make sure <strong>BeamMP AuthKey</strong> holds a valid key, click <strong>Save startup</strong> and <strong>Restart</strong>. If it still does not appear, read the <strong>Console</strong> tab for [ERROR] or [WARN] lines and check the <strong>Troubleshoot</strong> tab. The panel assigns the port, so there is nothing to open on your side.
Can I use one AuthKey for two servers?
A key works on one server at a time, and each account gets a limited number of keys. Create a separate key in Keymaster for each server you run.
What port does a BeamMP server use?
The game's default is 30814, over both TCP and UDP. On ChicagoServers the panel assigns your port, and it is shown on the <strong>Startup</strong> tab under <strong>Network</strong> with the address to copy. You do not set it yourself, and a <code>Port</code> value edited in the file is overwritten from the Startup tab at every start.
What does MaxCars do?
It limits how many vehicles each player can have spawned at once. Extra vehicles are deleted instantly. On the panel it is the <strong>Cars per player</strong> field on the <strong>Startup</strong> tab. MaxPlayers only limits player slots and does not affect the vehicle count.