Get started

Free trial Try a game free for 3 days. No card needed. Start a free trial Start a free trial

Game server hosting

All games

Guides / Arma Reforger / Mods

How to install Arma Reforger mods on your server

Add Workshop mods to an Arma Reforger server from the panel's Mods page, or by editing the mods array in config.json. Restart to apply the change.

Updated , checked on Arma Reforger 1.8.0.13

A Reforger server loads the mods listed in game.mods of its config.json, and downloads them when it starts. In the ArthOS panel you add them from the Mods page, then restart the server.

In the ArthOS panel

  1. Open your server and choose Mods.

  2. Open the Workshop tab. Search by name, or browse with the sort menu (Most popular, Newest, Best rated).

  3. Select a mod’s picture to read its details, or choose Add on its card.

  4. Choose Add. The panel adds only that mod, at the end of your list. The first time you add a mod to a server, a box called “When you add a mod to this server” asks which you want.

    The game fetches what a listed mod needs every time the server starts. To put those mods on the list too, turn on Add dependencies too above the results before you add. They then go directly above the mod.

  5. Open On this server to see the list. A new row says “not downloaded yet”.

  6. Restart the server. It downloads the mods on the list as it starts, and each row then shows the installed version. Players download the same mods when they first join.

Workshop tab of the Mods page: search box, sort menu, Add by ID, Add dependencies too and mod cards with Add buttons
  1. Workshop tab
  2. Search the Workshop
  3. Sort by
  4. Add dependencies too
  5. Add

Click Workshop (1), type a name in the search box (2), change the order with the sort menu (3), turn on Add dependencies too (4) if you want the mods it needs on the list, and choose Add (5) on the card you want. A mod already on the list shows On this server instead of Add. You need permission to edit files on the server to add or remove mods; without it the page is read only.

A mod adds content; it does not change the game mode by itself. To play a mission that comes with a mod, pick or paste its scenario in Config Editor under Scenario, then restart. See scenario IDs.

Take a mod off or lock a version

Each row has a version menu at its right. It defaults to Latest. Pick a version to lock the mod to it; load order, presets and folders shows how to lock every mod at once. To take a mod off, choose the bin icon at the end of its row, or tick several rows and choose Remove. The mod stops loading at the next start. Its files stay in /profile/addons in Files. Clear old mods on the On this server tab removes the ones nothing uses any more, and it is permanent: see remove a mod.

On this server tab: a mod row with its version menu, row menu and bin icon
  1. A mod row

The three dots on a row open its menu: Disable (keep on this list), and Keep first or Keep last under Load order. See disable a mod and keep a mod first or last.

The row menu of a mod, with Disable, Keep first and Keep last
  1. Disable
  2. Keep first
  3. Keep last

By hand

Edit config.json (in Files on the panel, or on your own host) and add the mod to game.mods:

{
  "game": {
    "mods": [
      {
        "modId": "5AAF6D5352E5FCAB",
        "name": "Project Redline - Core"
      },
      {
        "modId": "59D64ADD6FC59CBF",
        "name": "Project Redline - UH-60",
        "version": "1.4.1"
      }
    ]
  }
}

What each key does, from Bohemia’s server config documentation:

  • modId: the mod’s GUID. Copy it from the mod’s Workshop page, where it is listed as ID. See how to find a mod ID.
  • name: does nothing. It is only a comment so you can read the list.
  • version: optional. Leave it out and the latest version is used.
  • required: optional, true by default. Set it to false and a mod the server cannot download is dropped from the list with a warning in the log, instead of stopping the server.

Bohemia also describes a shortcut: in the game’s Mod manager, the JSON tab has a Copy to clipboard button that produces a ready list.

Moving from another server? Use Import on On this server and paste its config.json or mod list.

Save the file and restart the server. The panel does the same edit for you, and its page refuses a change if the file changed since the page loaded, so you never overwrite a newer list.

If it does not work

  • The server will not start after adding a mod. One bad entry can stop it: a wrong ID, a mod removed from the Workshop, or a mod that needs another one that is missing. Read the red box at the top of On this server: it lists the last start’s mod problems. If it does not name a mod, use the Troubleshoot tab: find the mod that stops your server.
  • The mod does not show on the Workshop tab. Search is by name. Use Add by ID on the Workshop tab: paste the 16-character ID or a Workshop link, check the mod and what it needs, then choose Add. Typing the 16-character ID in the Workshop search box also shows that mod, even if it is hidden.
  • A change did nothing. Mods only load on a restart. Check the row says “installed” with a version after the server has started.
  • The panel says “Not started” after a hand edit. At each start the panel repairs the usual hand mistakes in config.json (a comma before } or ], a doubled or missing comma, a comment, an extra closing bracket) without touching your values. If it cannot repair the file, it puts back the newest earlier copy that is valid. Only when neither works does it leave the file as it is and say “Not started”. What it did shows on the server’s Crashes page. Saves made from the panel’s own pages still refuse invalid JSON; fix it in Files, or restore a backup.

Need a server to try this on? See Arma Reforger servers.

Sources: Bohemia wiki: Server Config, reforger.armaplatform.com: Workshop

Arma Reforger server hostingAll Arma Reforger guides