Dedicated server guide

BATTALION: Legacy

Manage btlserver 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

7777/UDP, 7777/TCP, queryport/UDP, queryport/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-btlserver create btlserver
Complete interactive setup ./alphagsm-docker my-btlserver setup
Start the game server ./alphagsm-docker my-btlserver start
Check the instance status ./alphagsm-docker my-btlserver status

./alphagsm-docker start
./alphagsm-docker my-btlserver create btlserver
./alphagsm-docker my-btlserver setup
./alphagsm-docker my-btlserver start
./alphagsm-docker my-btlserver 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-btlserver create btlserver
Complete interactive setup ./alphagsm my-btlserver setup
Check the host prerequisites ./alphagsm my-btlserver doctor
Start the game server ./alphagsm my-btlserver start
Check the instance status ./alphagsm my-btlserver status

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

This guide covers the btlserver module in AlphaGSM.

btlserver is currently PASSED in the checked-in support tracker on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane validates both process and Docker runtimes for this module, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

screen
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mybtlserve create btlserver

Run setup:

alphagsm mybtlserve setup

Start it:

alphagsm mybtlserve start

Check it:

alphagsm mybtlserve status

Stop it:

alphagsm mybtlserve stop

Setup Details

Setup configures:

the game port (default 7788)
the install directory
SteamCMD downloads the server files

Useful Commands

alphagsm mybtlserve update
alphagsm mybtlserve backup

Notes

Module name: btlserver
Default port: 7788
The Docker contract launches the Unreal payload as the mapped host user; the game refuses to run as root.

Server variables

After create btlserver, 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.
`port`	gameport	integer	The game port for the server. Example: `7777`.
`queryport`	—	integer	The query port for the server. Example: `27015`.

Developer Notes

Run File

Executable: Battalion/Binaries/Linux/BattalionServer-Linux-Shipping
Location: <install_dir>/Battalion/Binaries/Linux/BattalionServer-Linux-Shipping
Engine: Custom (SteamCMD)
SteamCMD App ID: 805140

Server Configuration

Config file: See game module source
Template: See server-templates/btlserver/ 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 BATTALION: Legacy?

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

Which runtimes can run BATTALION: Legacy?

Declared runtimes: Docker or a Linux host process.

Which ports does BATTALION: Legacy use?

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

Can I add mods to BATTALION: Legacy?

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

How should I back up BATTALION: Legacy?

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