How to Configure Your Holdfast Server

Holdfast server configuration controls everything from the server name and password to game modes, player limits, map rotations, and admin access. On AleForge, simple settings live on the Startup page, while advanced settings are managed through config files in holdfastnaw-dedicated/configs.

AleForge’s default config file is aleforge-default.txt. The official Holdfast wiki documents the full range of config options for self-hosted servers using serverconfig_default.txt.

Quick Settings on Startup

Setting	Startup Variable	Guide
Server name	SERVER NAME	Change Server Name
Server password	SERVER PASSWORD	Set Server Password
Active config file	Config File	See below

Applying a Config File on AleForge

Game modes, admins, map rotations, and advanced gameplay settings are configured in your Holdfast config file.

Using the Config Generator (Recommended)

1. Open the AleForge Holdfast Config Generator
2. Optionally Import Configuration from an existing file, or start fresh
3. Configure server settings using the navigation menu
4. Click Generate Config, then Download Config

Upload and Activate the Config

1. Open the Blacksmith’s Portal and select your Holdfast server
2. Go to Files → holdfastnaw-dedicated/configs and upload your config file
3. Go to Startup and set the Config File variable to your newly uploaded filename
4. Restart your server

Note: Stop your server before uploading a new config file. Check Console after restart to confirm settings loaded without errors. Use a custom filename rather than overwriting aleforge-default.txt, see Protect Your Config on Update.

Server Identity Settings

Setting	Description	Example
server_name	Name displayed in the server browser	server_name My Holdfast Server
server_password	Password required to join (blank = public)	server_password secret123
server_region	Region for server browser filtering	server_region europe
max_players	Maximum players allowed	max_players 150

On AleForge, server name and password are easiest to manage from Startup.

Network Settings

Both ports must be unique for each server instance. Per the Holdfast wiki:

Setting	Description	Default
server_port	Game port (UDP)	20100
steam_query_port	Steam query port, enables server browser info (UDP)	27000
tick_rate	Server tick rate	30
max_ping	Maximum allowed player ping (0 = no limit)	0

See Holdfast Server Ports and Firewall for port forwarding guidance on self-hosted servers. AleForge handles network configuration for hosted servers.

Game Mode Settings

Setting	Description	Example
game_mode	Active game mode	game_mode 0
round_time_minutes	Round duration in minutes	round_time_minutes 15
auto_balance_teams	Automatically balance team sizes	auto_balance_teams true
friendly_fire	Enable friendly fire damage	friendly_fire false
allow_spectators	Allow players to spectate	allow_spectators true

See Change Holdfast Game Mode for all mode options.

Common Game Mode Values

Value	Game Mode
0	Army Battlefield
1	Army Deathmatch
2	Army Siege
3	Naval Battlefield

The Config Generator also supports Army Assault, Army Conquest, Coastal Siege, Invasion, Melee Arena, Naval Assault, and Offensive.

Admin Settings

Setting	Description	Example
admin_steam_id_64	Steam64 IDs of admin players	admin_steam_id_64 76561198012345678
server_admin_password	Admin password (self-hosted alternative)	server_admin_password myAdminPW

See Holdfast Server Admins for step-by-step instructions.

Map Rotation

map_rotation KF-BattleofWaterloo
map_rotation KF-FortBaxter
map_rotation KF-PortRoyal
map_rotation KF-TheFarm

Tip: The server cycles through maps in listed order. The Config Generator provides a visual interface for building rotations with per-map game modes.

Override Commands

For line battles, regiment events, and custom scenarios, Holdfast supports override commands that control spawn classes, weapons, ammo, ships, artillery, and capture points. These are added inside your config file, typically within a map rotation block.

See Holdfast Config Overrides Explained for a full guide, or the official Holdfast Server Configuration wiki for every command.

Example Configuration

// Server Identity
server_name [US East] Army Battlefield | AleForge Community
server_password
server_region europe
max_players 100

// Network
server_port 20100
steam_query_port 27000

// Game Mode
game_mode 0
round_time_minutes 15
auto_balance_teams true
friendly_fire false
allow_spectators true

// Admin Access
admin_steam_id_64 76561198012345678

// Map Rotation
map_rotation KF-BattleofWaterloo
map_rotation KF-FortBaxter
map_rotation KF-PortRoyal

// Gameplay
spawn_protection_time 3
class_limit_enabled false
allow_flag_bearer true
allow_sapper true

Verifying Your Configuration

1. Check Console on the Blacksmith’s Portal for startup errors
2. Connect and verify, server name, password, and game mode

Self-Hosting/Other Providers

1. Copy serverconfig_default.txt to a custom filename before editing (see Protect Your Config on Update)
2. Point your launch script to the custom config with --serverConfigFilePath
3. Restart and verify in-game