How to Add Workshop Mods to Your Arma Reforger Server
Install Steam Workshop mods on your Arma Reforger server using the Config Editor's mod manager or by editing config.json directly.
Arma Reforger mods are automatically downloaded from Steam Workshop — you just add the mod ID to your config. The XGamingServer Arma Reforger Config editor includes a built-in mod browser with auto-dependency resolution.
Open the Config Editor
In the XGamingServer Panel, click Arma Reforger Config in the sidebar.
Go to the Mods tab
Click the Mods tab in the editor.
Search for a mod
Type a mod name, author, mod ID, or Workshop URL in the search bar. Results show with thumbnails, names, and IDs.
Add it
Click Add on the mod you want. The mod is added to your config and dependencies are automatically resolved (added too).
(Optional) Manage the mod
- Toggle Required on each mod to control whether clients must have it
- Click Remove to delete a mod from the config
- Use Import/Export to bulk manage mod lists as JSON
Save and restart
Click Save Changes, then restart the server from Console. The server downloads the mods on startup.
Manually Add by Mod ID
If the search doesn't find your mod:
Get the Mod ID
The 16-character hex ID is on the Steam Workshop page URL — the string after ?id=. Or check the mod's ServerData.json file.
Enter it
In the Mods tab, enter the Mod ID in the manual-add field. Optionally add a friendly name.
Click Add Mod
Save and restart.
Edit config.json
In Files, open config.json. Add mods to the mods array inside the game block:
"mods": [
{
"modId": "597D72161FD1ED1D",
"name": "My Mod",
"version": "",
"required": true
}
]| Field | Description |
|---|---|
modId | 16-char hex ID from the Workshop page or mod's ServerData.json |
name | Human-readable label (cosmetic only) |
version | Pin to a specific version, or "" for always-latest |
required | If true, clients must have this mod to join |
Save and start
Click Save Content and start the server from Console.
Finding Mod IDs
| Source | How |
|---|---|
| Steam Workshop URL | The hex string after ?id= |
Mod's ServerData.json | Inside the mod folder |
| Config Editor search | Easiest — search by name or author |
Required vs Optional Mods
In config.json:
"modsRequiredByDefault": trueWhen true, all mods in the list are required unless individually set to required: false. When false, mods are optional unless individually set to required: true.
How Auto-Download Works
- The server downloads mods on first startup after they're added to the config
- Players auto-download required mods when they connect
- Console players (Xbox/PlayStation) cannot install mods, so modded servers reject them
Related Guides
How is this guide?
Arma Reforger Mission Header Settings Reference
Customize your Arma Reforger scenario with mission header settings for server name, time of day, weather, XP multiplier, and more.
How to Optimize Arma Reforger Server Performance
Tune your Arma Reforger dedicated server for better FPS, lower lag, and smoother gameplay through view distance, AI limits, mod audits, and restart schedules.