Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
VGSources
Blog

BeamMP ServerConfig.toml Explained: Every Setting, Network Setup, and Troubleshooting Tips

A complete guide to BeamMP ServerConfig.toml: generated-file location, every General setting, safe configuration, networking, public listing, maps, capacity limits, environment overrides, and troubleshooting.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

ServerConfig.toml is BeamMP-Server’s main configuration file. It controls the listening port, network binding, public or private visibility, authentication, server-list text, map, resource directory, player and vehicle limits, and diagnostic logging. BeamMP-Server creates the file on its first startup; edit that generated copy, then restart the process for changes to be read.

The most important detail is location: the configuration, logs, and Resources directory are created relative to the server process’s working directory. A file beside the executable may be ignored if a service, container, shortcut, or script starts BeamMP-Server elsewhere.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What ServerConfig.toml does

The file uses TOML syntax and normally contains a single [General] section. Text values must be quoted. The comments in the file generated by your installed BeamMP-Server version are the most current explanation of its options, so keep that template available when upgrading.

Do one initial launch before making a large configuration. The first run creates the current file structure, log location, and resource folder. Stop the server, edit the generated file, and start it again. If your server is managed by a system service or container, identify its working directory first; otherwise you can spend time changing a configuration that the running process never opens.

#1 Best Overall
Sale
Logitech G920 Driving Force Racing Wheel and Pedals, Force Feedback + Logitech G Driving Force Shifter - Xbox Series X|S, Xbox One and PC, Mac - Black
  • REALISTIC RACING SIMULATION DUO: Feel what is like to drive a real race car with G920 Driving Force Racing Wheel & Pedals and Driving Force Shifter
  • PAIRED FOR PRECISION: Take full control of the race with G920 Driving Force Racing Wheel & Pedals and Driving Force Shifter
  • PRECISE CONTROL: Helical transmission gears reduce noise and vibration with anti-backlash keeping wheel and pedals tight. The six-speed “H” shifter helps you execute smooth, accurate gear transitions
  • FORCE FEEDBACK: The dual motor force-feedback realistically simulates the feel of tires on a turn, understeer, oversteer, drifting and more
  • PREMIUM BUILD: Look, feel and durability of a real race car wheel, pedals and shifter. Wheel cover, knob and boot are covered in high-quality, hand-stitched leather with a solid steel gear shaft and polished metal pedals

Settings at a glance

Setting What it controls Important limits or cautions
Port TCP/UDP network port on which the server is reachable. Use an unused port from 1024 through 65535. Router forwarding and firewall rules must use the same value.
IP Local address to which BeamMP-Server binds. The official example uses ::. Keep the generated value unless you have a specific multi-interface or IPv6 requirement.
AuthKey Authentication key used to identify a public server with the BeamMP backend. Treat it as a secret. Do not publish it in repositories, screenshots, support posts, or copied logs.
Private Whether the server is hidden from the public server list. true keeps it out of the list. Use false only when you intend to list it and have valid authentication configured.
Name The server name displayed to players. BeamMP’s documented maximum is 250 characters.
Tags Search and classification text shown with the server. Use concise comma-separated terms that describe the actual server.
Description Longer server-list information. BeamMP’s documented maximum is 1,000 characters.
MaxPlayers Maximum simultaneous players. No universal performance value is established in the official documentation; hardware, map, mods, and network conditions determine a practical limit.
MaxCars Maximum vehicles each player may have spawned. Extra vehicles a player attempts to spawn are deleted immediately.
Map Initial map path loaded by the server. Use a valid installed path, such as /levels/gridmap_v2/info.json. A custom map must be installed as a server resource.
ResourceFolder Directory containing server resources and custom content. It may be a separate valid path. Ensure the process can read it.
LogChat Whether chat activity is written to logs. Useful for a specific moderation or troubleshooting need; disable noisy logging for routine operation if you do not need it.
Debug Additional diagnostic logging. Enable temporarily while investigating a problem, then return to the normal setting.
InformationPacket An operational information switch shown in the official setup example. Keep the generated value unless you have a reason to change it and understand the installed version’s comment.
AllowGuests A guest-access option present in the generated setup example. The safe example uses false. Follow the comment in your generated file because behavior and wording are version-specific.

A safe starting configuration

This example follows the official setup structure. Replace the authentication key, identity text, map, and capacity with values appropriate for your installation.

[General]
Port = 30814
AuthKey = "your-auth-key"
AllowGuests = false
LogChat = false
Debug = false
IP = "::"
Private = true
InformationPacket = true
Name = "My BeamMP Server"
Tags = "Freeroam,Modded,Racing"
MaxCars = 2
MaxPlayers = 10
Map = "/levels/ks_nord/info.json"
Description = "Friends server"
ResourceFolder = "Resources"

Keep the [General] header. TOML is strict about spelling, equal signs, quotation marks, and value types: true and false are booleans, while names, paths, tags, and keys are quoted strings. A malformed line can prevent the server from loading the intended settings, so change one logical group at a time and check the startup log after each restart.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How to configure a server step by step

  1. Run BeamMP-Server once. Start it from the directory where you intend to operate it. Allow the first launch to create ServerConfig.toml, logs, and the resource directory, then stop the process cleanly.
  2. Open the generated file. Confirm that it is the copy in the process’s working directory, not merely a copy next to the executable. If you use a service, inspect its configured working directory; if you use a container, check the mounted path.
  3. Choose an unused port. Select a value from 1024–65535 and verify that no other service on the host already occupies it. The example value 30814 is not a universal requirement.
  4. Set identity and access. Enter a descriptive Name, useful Tags, and a Description. Keep Private = true while testing or when you want direct-connect access only. Add the valid AuthKey required for a public listing before switching to Private = false.
  5. Set map and resources. Point Map to an installed map’s info.json. Put custom content in the configured resource directory and verify its path and spelling. A path that is valid on your development machine may not exist on the host.
  6. Set capacity conservatively. Use MaxPlayers for the player ceiling and MaxCars for each player’s vehicle ceiling. Begin with values your hardware can sustain, then observe server logs, simulation stability, and player experience before increasing them.
  7. Save and restart. BeamMP-Server rereads the configuration at startup. A running process generally continues using the values loaded during its previous launch.
  8. Test locally, then externally. Connect from the host or local network first. After networking rules are in place, test from outside the host’s network so you can distinguish a configuration error from a router or firewall problem.

Port forwarding and firewall requirements

A correct TOML file cannot make an unreachable port work. The same port must be free on the host, forwarded by the router when the host is behind a private network, and permitted through the host firewall.

Rank #2
Sale
MOZA R5 Bundle Racing Wheel, Direct Drive Base, Pedals Simulator Kit for PC
  • MOZA R5 Racing Wheel and Pedals Bundle Kit is designed for PC Users (Not Compatible with Xbox and ps), provides an affordable, direct-drive setup force feedback system that transforms your sim racing experience.
  • Direct-Drive Simulator: Delivers smooth, detailed 5.5 Nm peak torque without the mechanical slack or noise of older gear- and belt-driven wheels.
  • Ready-to-Race Kit: Includes the wheel base, MOZA ES Steering Wheel with an aluminum quick-release system, and steel pedals and desk clamp in a single package.
  • ES Wheel: At 280mm (11 inches), the compact diameter gives the motor maximum leverage, ensuring the 5.5Nm force feedback feels crisp, strong, and detailed rather than dampened or weak.
  • SR-P Lite Pedals(No Clutch): Crafted from high-strength steel, this Pedal with throttle and brake feature precise Hall sensors, adjustable spacing and height, customizable output curves, and an anti-slip base—offering reliable, adaptable performance for any setup.
  1. Choose the Port value in ServerConfig.toml and record it.
  2. Create a router port-forwarding rule from that external port to the BeamMP host’s internal address. Use the same port number and the protocol coverage required by the official setup guide.
  3. Allow BeamMP-Server through the host firewall for incoming and outgoing TCP and UDP on that port. A rule for only one protocol can produce partial or inconsistent connectivity.
  4. Keep the host’s local address stable, for example with a DHCP reservation, so the router rule does not silently point to another device.
  5. Have a player outside your home network test the connection. Local testing alone can succeed even when inbound traffic from the internet is blocked.

For an intentionally private server, leave Private = true and give trusted players the host address and port through Direct Connect. A private server is not supposed to appear in the public list. For a listed server, set Private = false, use a valid AuthKey, and confirm that forwarding and firewall rules are complete.

Why a server is missing from the server list

Private mode is still enabled

Private = true explicitly suppresses listing. This is the first setting to check when players can connect directly but cannot find the server in the browser.

Public authentication is incomplete

A public server needs a valid AuthKey so the BeamMP backend can identify it. Check for extra spaces, missing quotation marks, a key copied into the wrong working directory, or a service that starts with a different configuration path. Never post the key while asking for help; redact it before sharing logs or screenshots.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Razer Wolverine V3 Pro Wireless Gaming Controller: Licensed for Xbox Series X|S, Xbox One, Windows PC - 6 Remappable Buttons - Fast Triggers - Customizable Thumbsticks - Wired Tournament Mode - Black
  • 4 MOUSE CLICK BACK BUTTONS & 2 CLAW GRIP BUMPERS — Enjoy the same ultra-responsive actuation found in Razer's top gaming mice with 4 buttons built into the controller’s ergonomic, rubberized handles—topped with 2 claw grip bumpers for even more control
  • PRO HYPERTRIGGERS — Set the triggers for instant actuation with zero travel time or ultra precise analog control—be fully immersed in the action and feel every trigger pull with integrated haptic vibrations
  • HALL EFFECT PRECISION THUMBSTICKS — Experience analog thumbsticks that are not only more accurate than traditional models but are smoother, lighter, and more durable thanks to their anti-friction rings and pro grade materials
  • HYPERSPEED WIRELESS — Delivering an ultra-low latency 2.4 GHz connection via its USB Type A dongle, experience fast, reliable performance that meets the demands of the most intense competitive players on Xbox and PC
  • RAZER MECHA-TACTILE ACTION BUTTONS & 8-WAY FLOATING D-PAD — By combining the speed of microswitches with the cushioned comfort of a rubber membrane, compete with quicker inputs that feel just as comfortable to press

The process is using another file

Launch location controls where the configuration and logs are created. Compare the timestamp and contents of the file you edited with the file path used by the service, script, shortcut, or container. Restart only after confirming you changed the active copy.

Networking is blocked

Listing and direct connectivity can both be affected by a conflicting port, missing router forwarding, or a firewall rule that omits TCP or UDP. Check all three layers with the exact value configured under Port.

Maps, resources, and capacity limits

Map paths

The Map value must identify content installed on the server, not merely content installed in a player’s game directory. A standard-style value is /levels/gridmap_v2/info.json. For a custom map, install it as a server resource, then use the path exposed by that resource and confirm the startup log reports successful loading.

Rank #4
Obokidlyamor 2PCS Simulation Turbine Intake Pipe Wind Sense Speed Change on Steering Wheel PC USB for Logitech G923 G920 G29 Pro RS50 Base Intake Pipe Sim Racing Wind Simulator (Red)
  • PC USB Simulation Racing Game Wind Sense Simulator Wind Speed Change on Steering Wheel of Racing Game for Logitech G923 G920 G29 G /Thrustmaster T300RS T500
  • Supports SIMHUB software and can be debugged on it.It suitable for 20/30/40 aluminum profiles and cockpit brackets with suitable holes.you can read the game data in real time, calculated by racing speed.
  • The maximum speed is 7000 rpm/second.The maximum and minimum air quantity can be set. The default starting air volume is 60km/h. The faster the car, the greater the air quantity.
  • Very High Wind Speed For Simulation Racing Game Wind Sense Simulator steering wheel.Easy assembly and high adaptability. Compatible with aluminum profiles in the sizes of 20x20mm/0.8x0.8", 30x30mm/1.2x1.2" and 40x40mm/1.6x1.6". As for other brackets, please contact the customer service.
  • Support many games, including for American Truck Simulator, Assetto Corsa, Euro Truck Simulator 2, Assetto Corsa Competizione, Automobilista, Codemasters F1 2019, Codemasters F1 2020, Automobilista 2, BeamNG Drive, Codemasters F1 2021, Codemasters F1 22, Farming Simulator 22, Forza Horizon 4, IRacing, RFactor 2, Forza Horizon 5, Forza Motorsport 7, Project Cars 2, Project Cars 3, WRC 10 FIA World Rally Champion, WRC 8/9 FIA Word Rally Champion, Codemasters Dirt 3, and Codemasters Dirt 4.

ResourceFolder

ResourceFolder defaults to the relative Resources location in the setup example, but it can be a separate valid path. Relative paths depend on the working directory; absolute paths reduce ambiguity when a service starts from an unexpected directory. Ensure the BeamMP process account has permission to read the directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

MaxPlayers and MaxCars

MaxPlayers limits connected players. MaxCars applies per player, not to the entire server: when a player tries to exceed the limit, the additional cars are deleted immediately. There is no official universal player-or-car number that guarantees smooth performance. Tune in stages for your CPU, memory, map complexity, modifications, and upload capacity, and watch for simulation stalls or unstable connections.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Environment-variable overrides

Since server release 3.2.0, General settings can be overridden with environment variables. Convert the PascalCase setting name to uppercase words separated by underscores and prepend BEAMMP_.

Best Value
Obokidlyamor Turn Signal Headlight Dimmer Switch For PXN V99/ V10/V12 LITE Direct Drive Servo Wheel Base;Multi-Function Stalks Turn Wiper Lever Combination Racing Simulator Button Console Racing Wheel (For PXN V99)
  • Product Features ----Multi-Function Stalks Turn Wiper Lever+ Cruise Control Switches+ Ignition Switch Key for For PXN V99 Racing Wheel Euro truck simulator2 /American truck simulator/ OMSI 2/ The Bus/BeamNG.drive;Powerful game management with distinct configurations and logic for different games, automatically switching according to the game.No need to install drivers-plug and play.Support original steering wheel installation.
  • Product Turn Signal Headlight Switches functions ---- The stalks feature up to 18 programmable switches to cover all your driving needs.Support game Auto-Sync(No need to pause the game to adjust the position of the lever position when entering the game.); Meter/Low beam switch,High beam/light switch;you can switch small lights, headlights, switch instrument lights, turn signal, high beam, warning light, cruise light, can expand the vehicle start light, meter mode switch.
  • Product Turn Wiper Switches functions ---- 1.Switching to Universal Mode:Recommend binding buttons as:Upward lever: Right turn signal; Downward lever: Left turn signal. Pull lever closer: Flash headlights/Honk horn; Push lever away: Toggle high/low beams.2.Euro Truck Simulator mode:Three-speed windshield wiper( high speed / low speed / off switch).
  • Product Ignition Switch Technology ---- The key module is modified from the original HOWO heavy truck factory key. The LOCK position is used for steering wheel lock (ignored in-game).In Euro Truck Simulator (ETS2), there is only a single "ignition" option. Therefore, you can bind either OFF→ACC or ACC→ON for the ignition sequence.Engine start is performed from ON→START (START position).
  • Package including ---- 1X Basic kit;1X Kit adapter and some screws.If you find the Turn Signal Wiper Lever Switch could not connect to your Steering Wheel or could not work for your game, please do not worry and contact us via message first we will offer professional resolution to make it work again or replacement for free.
Configuration key Environment variable Value format
MaxPlayers BEAMMP_MAX_PLAYERS Supply the number as a string in the process environment.
Name BEAMMP_NAME Supply the text as a string; preserve spaces according to your shell or service syntax.
Any General boolean For example, a corresponding BEAMMP_... variable true or 1 turns it on; other values are interpreted as off.

This is useful for containers, automated deployments, and service templates where rewriting a file on every deployment is inconvenient. The manual also documents provider controls such as BEAMMP_PROVIDER_PORT_ENV and BEAMMP_PROVIDER_DISABLE_CONFIG. Provider behavior is version-sensitive, so verify those controls against the release notes for the exact BeamMP-Server version you run.

Keep the file and environment definitions consistent enough that an operator can understand the effective setup. When troubleshooting, record which variables are present, restart the process after changing them, and check the startup output for the resulting port, map, and capacity.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Self-hosting versus managed deployment

The configuration concepts remain the same, but responsibility changes depending on where the process runs.

Concern Self-hosted machine Managed or container deployment
Port and firewall You select the port, configure the operating-system firewall, and usually configure router forwarding. The provider may expose or map a port; you still need to match the value expected by the server and provider.
Files and resources You maintain the working directory, ServerConfig.toml, maps, and Resources. Use persistent mounts or the provider’s file manager so a rebuild does not erase content.
Backups and restarts You create backups and arrange scheduled or failure-triggered restarts. Check what backup, restart, and log-retention controls are actually included.
Capacity You choose limits based on your hardware and connection. Available CPU, memory, network allocation, and support policy determine practical limits; no universal value is promised by the BeamMP documentation.
Environment overrides Set variables in the shell, service definition, or container configuration. Use the provider’s environment interface and confirm it supports the BeamMP provider variables you need.

Common failures and fixes

  • Changes appear to do nothing: stop and restart the server, then verify the active working directory and configuration path.
  • Startup fails after an edit: restore the last known-good file, check the [General] header, quote text values, and look for misspelled keys or invalid TOML syntax.
  • Players cannot connect: confirm the port is unused, forwarded to the correct host, and allowed for both TCP and UDP by the firewall.
  • The map does not load: verify that the map is installed on the server, that the info.json path is exact, and that custom content is under the configured resource directory.
  • Extra vehicles disappear: this is expected when a player exceeds MaxCars; raise the value only if the host can handle the additional simulation load.
  • Logs are overwhelming: disable Debug or LogChat after collecting the evidence needed for diagnosis.
  • A public server remains unlisted: check Private = false, a valid unexposed AuthKey, the active configuration file, and complete networking rules.

Operational checklist

  • Generate the file once and retain the comments from the installed release.
  • Keep Port, router forwarding, and firewall rules identical.
  • Use Private = true for direct-connect testing and intentional private play.
  • Use Private = false only with the authentication and network setup required for listing.
  • Protect AuthKey as a credential.
  • Check map and resource paths on the server itself.
  • Change one group of settings, restart, and inspect logs before making more changes.
  • Tune player and vehicle limits from observed performance rather than an assumed universal number.
  • For release 3.2.0 and later, document any BEAMMP_ environment overrides alongside the file so deployments are reproducible.

Final guidance

Start with the generated template, keep the default bind address unless you have a networking reason to change it, and treat the port, forwarding, and firewall as one configuration. Visibility is controlled by Private; public identification additionally depends on AuthKey. Once the server can start reliably, validate the map and resources, then increase MaxPlayers and MaxCars gradually while observing real server behavior.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.