# Arma Reforger Server Startup Parameters Reference (/docs/arma-reforger/startup-parameters) 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** — `-maxfps` and `-MaxFPS` are identical. Essential Parameters [#essential-parameters] -config [#-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 [#-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 `-maxFPS` to 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 [#-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 MyCustomMod ``` Network Parameters [#network-parameters] -bindIP [#-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 [#-bindport] Overrides both `bindPort` and `publicPort` from the JSON config file. ``` ArmaReforgerServer.exe -bindPort 2001 ``` -a2sIpAddress [#-a2sipaddress] Overrides the A2S (Steam Query) IP address from the config. ``` ArmaReforgerServer.exe -a2sIpAddress "0.0.0.0" ``` -a2sPort [#-a2sport] Overrides the A2S (Steam Query) port from the config. ``` ArmaReforgerServer.exe -a2sPort 17777 ``` -nds [#-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 [#-nwkresolution] Defines the resolution of Spatial Map cells used by the networking system. ``` ArmaReforgerServer.exe -nwkResolution 10 ``` -staggeringBudget [#-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 200 ``` Logging Parameters [#logging-parameters] -logStats [#-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 5000 ``` This would log performance stats every 5 seconds. -logLevel [#-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 [#-logappend] Append to existing log files instead of overwriting them on each server start. ``` ArmaReforgerServer.exe -logAppend ``` -listScenarios [#-listscenarios] Logs all available scenario `.conf` file paths on startup. Useful for finding the `scenarioId` to use in your server config. ``` ArmaReforgerServer.exe -listScenarios ``` See [Scenario List](/docs/arma-reforger/scenario-list) for a complete list of official scenarios. AI Parameters [#ai-parameters] -aiLimit [#-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 [#-aipartialsim] Enables AI partial simulation mode for better performance with large AI counts. Added in v1.2. ``` ArmaReforgerServer.exe -aiPartialSim ``` Persistence Parameters [#persistence-parameters] -loadSessionSave [#-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 [#addon-parameters] -addons [#-addons] Specifies which mods to load. Space-separated mod names. ``` ArmaReforgerServer.exe -addons MyCustomMod AnotherMod ``` -addonsDir [#-addonsdir] Specifies the directory containing local addon/mod files. ``` ArmaReforgerServer.exe -addonsDir "C:\MyModsDir" ``` -addonDownloadDir [#-addondownloaddir] Override the directory where Workshop downloads addon files. ``` ArmaReforgerServer.exe -addonDownloadDir "D:\Downloads\Addons" ``` -addonTempDir [#-addontempdir] Override the directory for temporary addon files. Useful for permission-restricted environments. ``` ArmaReforgerServer.exe -addonTempDir "D:\Temp\Addons" ``` Profile and Debug Parameters [#profile-and-debug-parameters] -profile [#-profile] Sets the profile directory for logs, saves, and addon downloads. ``` ArmaReforgerServer.exe -profile /home/user/.config/ArmaReforgerServer ``` -freezeCheck [#-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 [#-disablecrashreporter] Disables the automatic crash reporter. ``` ArmaReforgerServer.exe -disableCrashReporter ``` -cfg [#-cfg] Force load a specific user engine settings configuration file. ``` ArmaReforgerServer.exe -cfg "myEngineSettings.conf" ``` All Parameters Summary [#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 [#setting-parameters-on-xgamingserver]
Open Startup settings [#1-open-startup-settings] Go to your server panel and click **Startup** in the sidebar.
Configure parameters [#2-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 [#3-restart-your-server] Restart from the **Dashboard** for changes to take effect.
Related Guides [#related-guides] See also: [Server Config Reference](/docs/arma-reforger/server-config-reference) | [Performance Guide](/docs/arma-reforger/performance-guide) | [Scenario List](/docs/arma-reforger/scenario-list) If you need help, join our [Discord](https://discord.xgamingserver.com/).