We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a BeamMP server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!
BeamMP guide

BeamMP ServerConfig.toml and AuthKey Setup Explained

By the ChicagoServers team · Updated · 8 min read

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.

Quick answer
  • 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.toml only at startup. On the Configs tab, edit, click Save, then Restart.
On this page
  1. How to get a BeamMP AuthKey from Keymaster
  2. Editing ServerConfig.toml on a ChicagoServers server
  3. ServerConfig.toml settings explained
  4. A working public server config
  5. Ports and why the server is not in the list
  6. Overriding settings with environment variables
  7. Frequently asked questions

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.

  1. Log in to Keymaster

    Open keymaster.beammp.com and sign in with Discord.

  2. Open Keys and add one

    Click Keys in the left sidebar, then the green + button in the top right.

  3. 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.

  4. Create and copy it

    Click Create, then use the clipboard icon to the right of the key to copy it.

  5. 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.

  1. 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.

  2. Edit it

    Use the Settings view for the common settings, or switch to Text to edit the whole file.

  3. 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.

SettingWhat it doesDefaultOn ChicagoServers
AuthKeyYour Keymaster key. The server will not start without it.emptyBeamMP AuthKey on the Startup tab
NameServer name shown in the list. Supports formatting codes. The backend limit is 250 characters.BeamMP ServerServer name on the Startup tab
DescriptionText shown in the list for public servers. Supports formatting codes. Limit 1000 characters.BeamMP Default DescriptionDescription on the Startup tab
TagsComma-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.FreeroamTags on the Startup tab
PortPort the server listens on. Any value from 1024 to 65535 that nothing else on the machine uses.30814Assigned by the panel (Startup tab, Network). Do not change it
IPLocal address to bind to. Leave it alone unless you know why you are changing it.::Leave it alone
MaxPlayersPlayer slots. Does not limit vehicles.8Set by your plan
MaxCarsVehicles per player. Extra spawns are deleted immediately.1Cars per player on the Startup tab
MapLevel 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.jsonMap on the Startup tab; Map from a mod for a custom map
Privatetrue keeps the server out of the public list. Players who know the IP and port can still join.truePrivate on the Startup tab
AllowGuestsWhether players who are not logged in to a BeamMP account may join.trueConfigs tab
InformationPacketLets clients that are not connected fetch your public server info directly from the server.trueConfigs tab
LogChatWrites chat messages to the log. The sample in the BeamMP setup guide shows false, but the v3.9.3 source default is true.trueConfigs tab
DebugVerbose logging. Greatly increases log size, so leave it off unless you are chasing a problem.falseConfigs tab
ResourceFolderWhere the Resources folder lives, so you can keep it away from the server files.ResourcesLeave 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.trueConfigs tab
UpdateReminderTime (under [Misc])How often the update reminder repeats, for example 30s, 10min, 2h or 1d.30sConfigs 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.

ServerConfig.toml
[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 = false

Raise 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 Port in 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.

We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a BeamMP server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

We offer quality support, a detailed knowledgebase, video tutorials on most topics, and even live support in case you prefer a live human.

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!