Server Startup Parameters
Complete reference of all startup parameters for Arma Reforger dedicated servers, including FPS limits, networking, logging, persistence, and performance tuning.
Arma Reforger's dedicated server supports various startup parameters that control how the server launches and runs. On XGamingServer, these can be set via the Startup page in your panel.
📝 Note: Parameters are case-insensitive —
-maxfpsand-MaxFPSare identical.
Essential Parameters
-config
Points the server to a specific configuration JSON file.
ArmaReforgerServer.exe -config "./Configs/Campaign_SWCoast.json"The path is relative to the server executable. On XGamingServer, this is configured automatically via the Startup page.
-maxFPS
Limits the server's maximum frames per second. This is critically important — without it, the server will try to use all available CPU resources.
ArmaReforgerServer.exe -maxFPS 60⚠️ Warning: It is heavily recommended to set
-maxFPSto a value between 60 and 120. Without this limit, your server may consume excessive resources and cause performance issues.
On XGamingServer, this is pre-configured to an optimal value.
-server
Instructs the executable to launch a local server and load a selected world. When this parameter is used, the -config parameter is ignored.
ArmaReforgerServer.exe -server "worlds/MP/MPTest.ent"This can be combined with -addons and -addonsDir for testing mods locally:
ArmaReforgerServer.exe -server "worlds/MP/MPTest.ent" -addonsDir "C:\MyModsDir" -addons MyCustomModNetwork Parameters
-bindIP
Overrides both bindAddress and publicAddress from the JSON config file. Useful for quick testing without editing the config.
ArmaReforgerServer.exe -bindIP "0.0.0.0"-bindPort
Overrides both bindPort and publicPort from the JSON config file.
ArmaReforgerServer.exe -bindPort 2001-a2sIpAddress
Overrides the A2S (Steam Query) IP address from the config.
ArmaReforgerServer.exe -a2sIpAddress "0.0.0.0"-a2sPort
Overrides the A2S (Steam Query) port from the config.
ArmaReforgerServer.exe -a2sPort 17777-nds
Network Dynamic Simulation — controls the diameter of cells replicated to clients. Higher values increase the networked view range but reduce performance. Set to 0 to disable NDS entirely.
ArmaReforgerServer.exe -nds 120-nwkResolution
Defines the resolution of Spatial Map cells used by the networking system.
ArmaReforgerServer.exe -nwkResolution 10-staggeringBudget
Maximum number of stationary spatial map cells processed per tick. Range: 1–10201. Defaults to the -nds diameter value if not set.
ArmaReforgerServer.exe -staggeringBudget 200Logging Parameters
-logStats
Logs the server's FPS and performance data at a specified interval (in milliseconds). Output includes FPS, frame time (avg/min/max), memory usage, player count, AI count, vehicles, and replication items.
ArmaReforgerServer.exe -logStats 5000This would log performance stats every 5 seconds.
-logLevel
Sets the detail level for log output.
| Value | Description |
|---|---|
normal | All messages (default) |
warning | Warnings and errors only |
error | Errors and fatal only |
fatal | Fatal errors only |
ArmaReforgerServer.exe -logLevel warning-logAppend
Append to existing log files instead of overwriting them on each server start.
ArmaReforgerServer.exe -logAppend-listScenarios
Logs all available scenario .conf file paths on startup. Useful for finding the scenarioId to use in your server config.
ArmaReforgerServer.exe -listScenariosSee Scenario List for a complete list of official scenarios.
AI Parameters
-aiLimit
Sets the maximum number of AI characters that can exist on the server. No system will be able to spawn AI when this ceiling is reached. A negative value disables the limit.
ArmaReforgerServer.exe -aiLimit 100-aiPartialSim
Enables AI partial simulation mode for better performance with large AI counts. Added in v1.2.
ArmaReforgerServer.exe -aiPartialSimPersistence Parameters
-loadSessionSave
Load a session save on startup. Pass empty to load the latest save for the current scenario, or pass a specific save UUID from the save's meta-info.json file.
ArmaReforgerServer.exe -loadSessionSave
ArmaReforgerServer.exe -loadSessionSave "550e8400-e29b-41d4-a716-446655440000"Addon Parameters
-addons
Specifies which mods to load. Space-separated mod names.
ArmaReforgerServer.exe -addons MyCustomMod AnotherMod-addonsDir
Specifies the directory containing local addon/mod files.
ArmaReforgerServer.exe -addonsDir "C:\MyModsDir"-addonDownloadDir
Override the directory where Workshop downloads addon files.
ArmaReforgerServer.exe -addonDownloadDir "D:\Downloads\Addons"-addonTempDir
Override the directory for temporary addon files. Useful for permission-restricted environments.
ArmaReforgerServer.exe -addonTempDir "D:\Temp\Addons"Profile and Debug Parameters
-profile
Sets the profile directory for logs, saves, and addon downloads.
ArmaReforgerServer.exe -profile /home/user/.config/ArmaReforgerServer-freezeCheck
Override the time in seconds before the server forcefully crashes on application freeze. Set to 0 to disable freeze detection entirely.
ArmaReforgerServer.exe -freezeCheck 120-disableCrashReporter
Disables the automatic crash reporter.
ArmaReforgerServer.exe -disableCrashReporter-cfg
Force load a specific user engine settings configuration file.
ArmaReforgerServer.exe -cfg "myEngineSettings.conf"All Parameters Summary
| Parameter | Type | Description |
|---|---|---|
-config | string | Path to JSON config file |
-maxFPS | number | FPS cap (recommended 60–120) |
-server | string | Launch with a specific world (bypasses -config) |
-bindIP | string | Override bind/public IP from config |
-bindPort | number | Override bind/public port from config |
-a2sIpAddress | string | Override A2S IP |
-a2sPort | number | Override A2S port |
-nds | number | Network Dynamic Simulation diameter (0 = disabled) |
-nwkResolution | number | Spatial Map cell resolution |
-staggeringBudget | number | Spatial map cells per tick (1–10201) |
-logStats | number | Performance log interval in ms |
-logLevel | string | Log verbosity: normal, warning, error, fatal |
-logAppend | flag | Append to existing log files |
-listScenarios | flag | List all scenario paths on startup |
-aiLimit | number | Max AI characters (-1 = unlimited) |
-aiPartialSim | flag | AI partial simulation mode (v1.2+) |
-loadSessionSave | string | Load a persistence save (optional UUID) |
-addons | string | Space-separated mod names to load |
-addonsDir | string | Local addon directory |
-addonDownloadDir | string | Override Workshop download directory |
-addonTempDir | string | Override temp addon directory |
-profile | string | Profile directory for logs/saves |
-freezeCheck | number | Freeze detection timeout in seconds |
-disableCrashReporter | flag | Disable crash reporter |
-cfg | string | Engine settings config override |
Setting Parameters on XGamingServer
Open Startup settings
Go to your server panel and click Startup in the sidebar.
Configure parameters
Enter the desired values in the startup variable fields. Most essential parameters like -config and -maxFPS are already configured for you.
Restart your server
Restart from the Dashboard for changes to take effect.
Related Guides
See also: Server Config Reference | Performance Guide | Scenario List
If you need help, join our Discord.
How is this guide?
How to Set a Password on Your Arma Reforger Server
Learn how to password protect your Arma Reforger server for private sessions, clan events, and restricted access.
How to Troubleshoot Common Arma Reforger Server Issues
Fix common Arma Reforger server problems including crashes, connection issues, and mod conflicts.