Skip to content

Identityserver

Jump to bottom
github-actions[bot] edited this page Oct 17, 2026 · 3 revisions

Identity

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.

Clone this wiki locally