Documentation Menu

config.json basics

The JSON config that drives everything on a Reforger server.

Reforger replaces Arma 3's server.cfg with config.json — a structured JSON file containing every server setting in one place.

Where it lives

/data/reforger/configs/server.json (path may vary by tier). Stop the server before editing.

A working baseline

{
  "bindAddress": "0.0.0.0",
  "bindPort": 2001,
  "publicAddress": "",
  "publicPort": 2001,
  "a2s": {
    "address": "0.0.0.0",
    "port": 17777
  },
  "rcon": {
    "address": "0.0.0.0",
    "port": 19999,
    "password": "<rcon-password>",
    "maxClients": 16,
    "permission": "admin"
  },
  "game": {
    "name": "Your Reforger Server",
    "password": "",
    "passwordAdmin": "<admin-password>",
    "admins": ["<your-bohemia-uid>"],
    "scenarioId": "{ECC61978EDCC2B5A}Missions/23_Campaign.conf",
    "playerCountLimit": 64,
    "visible": true,
    "crossPlatform": true,
    "supportedPlatforms": ["PLATFORM_PC", "PLATFORM_XBL"],
    "gameProperties": {
      "serverMaxViewDistance": 2500,
      "serverMinGrassDistance": 0,
      "networkViewDistance": 1500,
      "disableThirdPerson": false,
      "fastValidation": true,
      "battlEye": true,
      "VONDisableUI": false,
      "VONDisableDirectSpeech": false,
      "missionHeader": {}
    },
    "mods": []
  },
  "operating": {
    "lobbyPlayerSynchronise": true,
    "playerSaveTime": 120,
    "aiLimit": -1,
    "slotReservationTimeout": 60
  }
}

Important fields

  • bindPort + publicPort — the game port. Default 2001 UDP. They should match unless you're doing port forwarding.
  • a2s.port — Steam server browser query. Default 17777 UDP.
  • rcon.port — admin remote control. Default 19999 UDP.
  • game.scenarioId — which mission/campaign the server loads. See Scenarios.
  • game.password — empty = public, set to gate access.
  • game.passwordAdmin — in-game admin password.
  • game.admins — array of Bohemia Account UIDs (not Steam IDs) granted permanent admin. Find your UID at account.bistudio.com.
  • game.crossPlatform: true + supportedPlatforms — enable for Xbox crossplay. Limits the mod set to mods marked Xbox-compatible.

Validating

JSON has to be exact. Use a JSON linter or paste into jsonlint.com before saving — one missing comma and the server won't start.

The server logs syntax errors on boot. If your server refuses to start after editing, check the console first.

Connecting

In-game:

  1. Multiplayer → Server Browser
  2. Filter by name or Direct Connect with <ip>:2001
  3. Password if set

Admin login in-game

Open chat, type:

#login <passwordAdmin>

Useful follow-ups:

  • #shutdown — graceful stop
  • #restart — restart the scenario
  • #kick <playerId> — kick by ID (#players lists IDs)
  • #ban <playerId> — ban
  • #unban <playerId> — unban