Dedicated server guide

Citadel: Forged With Fire

Manage citadelserver with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Recorded lifecycle pass · Support evidence: 2026-10-16.

Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

queryport/UDP, queryport/TCP, 7777/UDP, 7777/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Mods and plugins

No mod support is declared in this snapshot; review the game guide before adding mods.

Backup hook

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Choose a supported runtime

Linux and Docker quickstart

Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-citadelserver create citadelserver
Complete interactive setup ./alphagsm-docker my-citadelserver setup
Start the game server ./alphagsm-docker my-citadelserver start
Check the instance status ./alphagsm-docker my-citadelserver status

./alphagsm-docker start
./alphagsm-docker my-citadelserver create citadelserver
./alphagsm-docker my-citadelserver setup
./alphagsm-docker my-citadelserver start
./alphagsm-docker my-citadelserver status

Host process

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Create the game instance ./alphagsm my-citadelserver create citadelserver
Complete interactive setup ./alphagsm my-citadelserver setup
Check the host prerequisites ./alphagsm my-citadelserver doctor
Start the game server ./alphagsm my-citadelserver start
Check the instance status ./alphagsm my-citadelserver status

./alphagsm my-citadelserver create citadelserver
./alphagsm my-citadelserver setup
./alphagsm my-citadelserver doctor
./alphagsm my-citadelserver start
./alphagsm my-citadelserver status

This guide covers the citadelserver module in AlphaGSM.

citadelserver remains supported on the documented Ubuntu 24.04 Linux baseline. The checked-in GitHub validation path for this server is Docker-first through the shared steamcmd-linux runtime. The current native Linux payload exposes the validated health surface as TCP on the managed game port; the configured query port remains published for the game itself but does not answer A2S reliably in CI. Replacement validation of this corrected contract is pending.

Requirements

Docker
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mycitadels create citadelserver

Run setup:

alphagsm mycitadels setup

Start it:

alphagsm mycitadels start

Check it:

alphagsm mycitadels status

Stop it:

alphagsm mycitadels stop

Setup Details

Setup configures:

the game port (default 7777)
the Steam query port (default 27015)
the install directory
SteamCMD downloads the native Linux dedicated-server payload for app 489650
AlphaGSM runs the validated Linux path through the shared steamcmd-linux Docker runtime

Useful Commands

alphagsm mycitadels update
alphagsm mycitadels backup

Notes

Module name: citadelserver
Default game port: 7777
Default query port: 27015
Supported Linux health contract: query, info, and info --json use TCP on the managed game port

Server variables

After create citadelserver, inspect or change these with set:

alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE

Key	Aliases	Type	What it does
`dir`	—	string	Install directory for the server.
`exe_name`	—	string	Server executable filename.
`map`	gamemap, startmap, level, worldname	string	The startup map.
`maxplayers`	users	integer	The maximum number of players. Example: `16`.
`port`	gameport	integer	The game port for the server. Example: `7777`.
`queryport`	—	integer	The query port for the server. Example: `27015`.
`servername`	hostname, name	string	The advertised server name. Example: `AlphaGSM Server`.

Developer Notes

Run File

Executable: CitadelServer.sh
Fallback executable: Citadel/Binaries/Linux/CitadelServer-Linux-Shipping
Location: <install_dir>/CitadelServer.sh
Engine: Native Linux dedicated server via SteamCMD
SteamCMD App ID: 489650

Server Configuration

Config file: See game module source
Max players: 50
Template: See server-templates/citadelserver/ if available

Maps and Mods

Map directory: Check game documentation
Mod directory: Check game documentation
Workshop support: No

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

Share your server

Sector Alpha server directory

When your server is ready, you can publish its connection details and community information on Sector Alpha. Review your listing and keep the information current.

Find a community

Browse the directory for game servers and their published connection details.

Browse server directory

Publish your server

Prepare a name, address and description for your listing.

Publish a server

Manual server sharing instructions

Frequently asked questions

What support evidence is recorded for Citadel: Forged With Fire?

Recorded lifecycle pass. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Which runtimes can run Citadel: Forged With Fire?

Declared runtimes: Docker or a Linux host process.

Which ports does Citadel: Forged With Fire use?

queryport/UDP, queryport/TCP, 7777/UDP, 7777/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Can I add mods to Citadel: Forged With Fire?

No mod support is declared in this snapshot; review the game guide before adding mods.

How should I back up Citadel: Forged With Fire?

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Source and support evidence

This guide mirrors AlphaGSM’s upstream documentation at 32cef5ba9e03053c8e461fffa0ba133b160b528d. Commands and prerequisites can change. Check current support notes before installation.

All game guides