This guide covers the identityserver module in AlphaGSM.
identityserver is currently ENABLED (BYO) on the documented Ubuntu 24.04
Linux baseline. The current GitHub integration lane still exercises both
process and Docker runtime selection around that archive-or-staged-tree
prerequisite, while local runs remain process-backed by default unless you opt
into the Docker backend.
Requirements
screen
- either a direct Identity server archive URL or a pre-staged Identity server tree
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm myidentity create identityserver
Run setup:
alphagsm myidentity setup
identityserver is supported in ENABLED (BYO) mode. Before setup or
start, either:
- set
url to a direct Identity server archive, or
- stage
IdentityServer.x86_64 and the rest of the Identity server files
inside your chosen <install_dir>/
Start it:
alphagsm myidentity start
Check it:
alphagsm myidentity status
Stop it:
alphagsm myidentity stop
Setup Details
Setup configures:
- the game port (default 7777)
- the install directory
- downloads and extracts the server archive when
url is set
Suggested flow:
alphagsm myidentity create identityserver
alphagsm myidentity set url https://example.invalid/identity-server.zip
alphagsm myidentity setup -n 7777 /path/to/identityserver
alphagsm myidentity start
Or, if you already have the server files:
alphagsm myidentity create identityserver
alphagsm myidentity setup -n 7777 /path/to/identityserver
## copy IdentityServer.x86_64 and the rest of the server tree into /path/to/identityserver/
alphagsm myidentity start
Useful Commands
alphagsm myidentity update
alphagsm myidentity backup
alphagsm myidentity set url https://example.invalid/identity-server.zip
Notes
- Module name:
identityserver
- Default port: 7777
Server variables
After create identityserver, inspect or change these with set:
alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE
This module does not declare schema-backed keys. set --list after
create is still the live source of truth.
Developer Notes
Run File
- Executable:
IdentityServer.x86_64
- Location:
<install_dir>/IdentityServer.x86_64
- Engine: Custom
Server Configuration
Maps and Mods
- Map directory: Check game documentation
- Mod directory: Check game documentation
- Workshop support: No
BYO file helper
Inspect this game's required files, source instructions and destinations with
alphagsm <server-name> assets requirements; check the declared files with
alphagsm <server-name> assets check. File checks do not establish game readiness.
This helper checks known sentinels only and directs you to stage the complete
compatible distribution manually; managed import is unavailable for this recipe.
See BYO files and private SteamCMD acquisition.