Skip to content

Smallandserver

github-actions[bot] edited this page Sep 11, 2026 · 3 revisions

Smalland

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

Clone this wiki locally