🔑 Get your auth key

BeamMP servers need a key from BeamMP themselves. Without one the server starts and immediately exits — if yours is doing that, this is almost certainly why.

1

Go to keymaster.beammp.com and sign in with your BeamMP account.

2

Create a new key. You will be asked for a server name and a player count — neither is binding, you can change them later.

3

Copy the key it generates.

4

In the panel, open the Startup tab and paste it into the auth key field if one is shown.

5

If there is no such field, open ServerConfig.toml on the Files tab and set AuthKey = "your-key" instead.

6

Start the server. The console should report a successful authentication within a few seconds.

⚙️ Configure the server

Everything else lives in ServerConfig.toml. It is TOML, so strings need quotes and numbers must not have them.

1

Stop the server, then open ServerConfig.toml in Files.

2

Name is what shows in the server list. MaxPlayers is the cap — be realistic, BeamNG is heavy and a high number will not go well.

3

Map takes a full path such as "/levels/gridmap_v2/info.json". Getting this wrong is the second most common reason a server will not boot.

4

Private = true keeps it off the public list.

5

Description is shown to people browsing.

6

Save and start.

🧩 Install mods

BeamMP pushes mods to clients automatically — people who join get them downloaded without doing anything. That is the good news. The bad news is large mod sets make joining slow.

1

Stop the server.

2

In Files, open Resources/Client.

3

Upload the mod .zip files exactly as downloaded. Do not unzip them.

4

Server-side-only resources go in Resources/Server instead — those are not pushed to players.

5

Start the server. Anyone joining now downloads the mods first, so expect their initial connect to take noticeably longer.

👥 Let your friends help run it

You can give friends access to the BeamMP server without ever sharing your account password. Sub-users get their own login and only the permissions you tick.

1

Open your server in the panel and go to the Users tab.

2

Click New User and enter their email address.

3

Tick the permissions you want them to have — Control for start/stop/restart and console, File for the file manager and SFTP.

4

They will get an email invite. Once they register they can manage the server from their own panel account.

💾 Keep your own backups

There are no server-side backups here. Every server has a backup allowance of zero — storing hundreds of gigabytes for a service nobody pays for is not something we can justify, so the Backups tab will not help you. The only copy of your world that exists is the one you download. Do this before any big change.

1

Stop the server from the Console tab in the panel. Archiving files while the server is writing to them is how you end up with a corrupt copy.

2

Open the Files tab and tick the box next to your save folder.

3

Click Archive. The panel packs the folder into a single file in the server root.

4

Click that archive and choose Download. For a large world, pull it over SFTP instead — browser downloads of multi-gigabyte files have a habit of failing near the end.

5

Delete the archive off the server once you have it, so it is not eating your disk space.

6

Keep the file somewhere safe. A server nobody plays on for seven days is removed, and your download is the only thing that survives that.

Server Setup Help