Experience authentic Cold War combat and join friends in the struggle for a sprawling, 51 km² mid-Atlantic island — or take on the role of Game Master and create your very own scenarios for others to enjoy.
Server version currently marked as early access by the Arma developers! Check back often for egg updates as more features are added to the server software.
From Bohemia Interactive's Website:
Experience authentic Cold War combat and join friends in the struggle for a sprawling, 51 km² mid-Atlantic island — or take on the role of Game Master and create your very own scenarios for others to enjoy.
config.json
file).config.json
file via Startup Parameters:
Port | Default | Protocol | Required | Notes |
---|---|---|---|---|
Game | 2001 | UDP | Yes | Primary port in Panel |
A2S | 17777 | UDP | No | Steam Query / Requires additional configuration in config.json |
RCON | 19999 | UDP | No | Requires additional configuration in config.json |
Bare Minimum | Recommended | |
---|---|---|
Processor | Recent x86/64 (AMD/Intel) processor. No ARM support. | Can use up to 300-600% CPU under load with uncapped FPS (set Max FPS to prevent). |
RAM | 3328 MiB | 6144-8192 MiB |
Storage | 5 GB | 7-10 GB (or more, depending on number of mods downloaded) |
Network | If node is behind a NAT, will require Egg Modification (*see Define Host Registered Bind Address | Wings Node is not behind a NAT |
Game Ownership | Not required to start or download mods. | ---- |
Currently, adding mods to your server is tricky because there is very little documentation and it is difficult to find mod IDs. Hopefully this will change in the future, but following these steps will get it to work:
My Documents\My Games\ArmaReforger\addons\
ServerData.json
files in a text editor.config.json
file for editing."mods": []
and replace it with the following:"mods": [
{
"modId": "591AF5BDA9F7CE8B",
"name": "Capture & Hold",
"version": "1.0.0"
},
{
"modId": "9A51598BACFBFDE7",
"name": "Explosive Goats Beta",
"version": "0.5.42"
}
]
modId
to equal the id
value found at the top of the ServerData.json
file you found.name
to equal the name
value found at the top of the ServerData.json
file you found.version
to equal the version
value found at the top of the ServerData.json
file you found.{}
sections like shown above. Make sure each {}
section has a ,
after it, except for the last item.The server will automatically download and run the mods you specify on startup. For mods that add scenarios, you can find the Scenario IDs listed as gameId
in the ServerData.json
file. Lastly, if a mod updates, you will likely have to change the version
value to match it's new version. You may also have to delete the mod folder in the addons/
directory to have it re-download (reports on this have been mixed).
The following are highly recommended variable modifications you can make to the egg after importing it to your panel.
Due to a current behavior of the Panel, SERVER_IP
will not return the node's public IP address if it is behind a NAT; it will return its private IP address. Unfortunately at this time, Arma Reforger requires the server's public IP address to be strictly defined within config.json
. If you know your node is behind a NAT (or you are finding your node's private IP address being added to config.json
), you will need to edit this egg after importing it by following these steps:
{{server.build.default.ip}}
and replace it with your node's public IP address. If done correctly, the line should now look something like this:"publicAddress": "123.4.56.789",
If you would like to restrict the maximum number of players that can join your client's server, you can change the permissions of the "Max Players" variable so that clients can only view this value (and not edit it). It's default value can also be changed, or the value can be changed on a server-by-server basis as desired.
Name | Tag |
---|---|
ghcr.io/ptero-eggs/steamcmd:debian | ghcr.io/ptero-eggs/steamcmd:debian |
Name | Description | Environment Variable | Default Value | User Viewable | User Editable |
---|---|---|---|---|---|
Automatic Updates | Quickly checks for any server or mod updates on startup, and updates if necessary. | AUTO_UPDATE | 1 | Yes | Yes |
Server Region | Region listed in the server browser. ISO 3166-1 alpha-2 codes can be used in this field. | REGION | US | Yes | Yes |
Server Name | Name displayed in the server browser. | SERVER_NAME | Arma Reforger Server | Yes | Yes |
Max Players | Maximum number of players allowed to join the server. | MAX_PLAYERS | 32 | Yes | Yes |
Server Password | Password required for clients to enter before they can join the server. Leave empty to have no password. | SERVER_PASS | Yes | Yes | |
Admin Password | ADMIN_PASS | Yes | Yes | ||
Scenario ID | ID of scenario to run/play. Valid IDs can be viewed in the console upon startup of the server. | SCENARIO_ID | {ECC61978EDCC2B5A}Missions/23_Campaign.conf | Yes | Yes |
Auto Joinable | Set if the session can be selected through the auto join feature. | AUTO_JOINABLE | true | Yes | Yes |
Visible in Server Browser | Set the visibility of the server in the Server Browser. | VISIBLE | true | Yes | Yes |
Enable BattlEye | Enables the anti-cheat engine on the server and requires all clients to be running it. | BATTLEYE | true | Yes | Yes |
Disable Third Person | DISABLE_THIRD | false | Yes | Yes | |
[Advanced] Max FPS | Sets a maximum FPS limit for the server, saving performance in some cases. Leave empty for no limit. | MAX_FPS | 120 | Yes | Yes |
[Advanced] Log FPS Interval | How often (in seconds) to log the FPS and other debug stats to the console. Set to 0 to disable. | LOG_INTERVAL | 0 | Yes | Yes |
[Repair] Validate Server Files | "true" to enable; empty to disable. Validates all server files when Automatic Updates is enabled. Note: This will significantly increase server startup times, so it is recommended to only enable this when needed. | VALIDATE | Yes | Yes | |
[Advanced] Arma Reforger Dedicated Server App ID | Used for installation and updates. Rarely needs to be changed. | SRCDS_APPID | 1874900 | No | No |
#!/bin/bash
## File: Pterodactyl Arma Reforger Egg - egg-pterodactyl-arma-reforger.json
## Author: David Wolfe (Red-Thirten)
## Date: 2024/07/03
## License: MIT License
## Image to install with is 'ghcr.io/ptero-eggs/installers:debian'
## Download and install SteamCMD
export HOME=/mnt/server
cd /tmp
mkdir -p $HOME/steamcmd $HOME/steamapps
curl -sSL -o steamcmd.tar.gz https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz
tar -xzvf steamcmd.tar.gz -C $HOME/steamcmd
cd $HOME/steamcmd
# SteamCMD fails otherwise for some reason, even running as root.
chown -R root:root /mnt
# Install/Verify game server using SteamCMD
./steamcmd.sh +force_install_dir $HOME +login anonymous $( [[ "${WINDOWS_INSTALL}" == "1" ]] && printf %s '+@sSteamCmdForcePlatformType windows' ) +app_update ${SRCDS_APPID} +app_update 1007 $( [[ -z ${SRCDS_BETAID} ]] || printf %s "-beta ${SRCDS_BETAID}" ) $( [[ -z ${SRCDS_BETAPASS} ]] || printf %s "-betapassword ${SRCDS_BETAPASS}" ) validate +quit
# Set up 32 and 64 bit libraries
mkdir -p /mnt/server/.steam/sdk{32,64}
cp -v linux32/steamclient.so /mnt/server/.steam/sdk32/steamclient.so
cp -v linux64/steamclient.so /mnt/server/.steam/sdk64/steamclient.so
## Arma Reforger setup
# Check for successful installation
if [[ ! -f $HOME/ArmaReforgerServer ]]; then
echo -e "\n\nSteamCMD failed to install the Arma Reforger Dedicated Server!"
echo -e "\tTry reinstalling the server again.\n"
exit 1
fi
mkdir -p $HOME/profile $HOME/tmp
echo -e 'Creating default "config.json" configuration file...'
cat > $HOME/config.json << EOF
{
"bindAddress": "0.0.0.0",
"bindPort": ${SERVER_PORT},
"publicAddress": "${SERVER_IP}",
"publicPort": ${SERVER_PORT},
"game": {
"name": "${SERVER_NAME}",
"password": "${SERVER_PASS}",
"passwordAdmin": "${ADMIN_PASS}",
"admins" : [],
"scenarioId": "${SCENARIO_ID}",
"maxPlayers": ${MAX_PLAYERS},
"visible": ${VISIBLE},
"gameProperties": {
"serverMaxViewDistance": 2500,
"serverMinGrassDistance": 50,
"networkViewDistance": 1000,
"disableThirdPerson": ${DISABLE_THIRD},
"fastValidation": true,
"battlEye": ${BATTLEYE},
"VONDisableUI": false,
"VONDisableDirectSpeechUI": false
},
"mods": []
}
}
EOF
echo -e "\nArma Reforger Dedicated Server successfully installed!\n"