This guide covers the smallandserver module in AlphaGSM.
smallandserver is currently PASSED on the documented Ubuntu 24.04 Linux baseline. The GitHub integration lane exercises process and Docker runtimes. Validation of the Docker host-user change is pending CI; local runs use the process runtime unless you select Docker.
Requirements
For Docker, run AlphaGSM as a normal user with Docker access. The server rejects root; its container uses your user and group IDs and a private writable home directory.
screen
- SteamCMD runtime libraries (
lib32gcc-s1, lib32stdc++6)
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm mysmalland create smallandserver
Run setup:
alphagsm mysmalland setup
Start it:
alphagsm mysmalland start
Check it:
alphagsm mysmalland status
Stop it:
alphagsm mysmalland stop
Setup Details
Setup configures:
- the game port (default 7777)
- the install directory
- SteamCMD downloads the server files
Useful Commands
alphagsm mysmalland update
alphagsm mysmalland backup
Notes
- Module name:
smallandserver
- Default port: 7777
Server variables
After create smallandserver, 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. |
port |
gameport |
integer |
Primary gameplay port. |
servername |
hostname, name |
string |
Configured public server name. |
serverpassword |
sv_password, password |
string |
Optional join password. Stored as a secret. |
worldname |
world, map, gamemap, levelname |
string |
Configured persistent world name. |
Developer Notes
Run File
- Executable:
SMALLANDServer.sh
- Location:
<install_dir>/SMALLANDServer.sh
- Engine: Custom (SteamCMD)
- SteamCMD App ID:
808040
Server Configuration
- Config file: See game module source
- Template: See server-templates/smallandserver/ if available
- Query/info behavior: AlphaGSM uses a generic UDP reachability probe on the main game port because the dedicated server binds a silent UDP listener rather than exposing A2S details
Maps and Mods
- Map directory: Check game documentation
- Mod directory: Check game documentation
- Workshop support: No