Dedicated server guide

ATLAS

Manage atlasserver with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Operator-provided prerequisites required · Support evidence: 2026-10-16.

Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

queryport/UDP, queryport/TCP, 57555/UDP, 57555/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

Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-atlasserver create atlasserver
Complete interactive setup ./alphagsm-docker my-atlasserver setup
Start the game server ./alphagsm-docker my-atlasserver start
Check the instance status ./alphagsm-docker my-atlasserver status

./alphagsm-docker start
./alphagsm-docker my-atlasserver create atlasserver
./alphagsm-docker my-atlasserver setup
./alphagsm-docker my-atlasserver start
./alphagsm-docker my-atlasserver status

Host process

Create the game instance ./alphagsm my-atlasserver create atlasserver
Complete interactive setup ./alphagsm my-atlasserver setup
Check the host prerequisites ./alphagsm my-atlasserver doctor
Start the game server ./alphagsm my-atlasserver start
Check the instance status ./alphagsm my-atlasserver status

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

This guide covers the atlasserver module in AlphaGSM.

atlasserver is currently ENABLED (BYO) on the documented Ubuntu 24.04 Linux baseline. The checked-in validation path is Docker-first because the shared steamcmd-linux runtime image carries the compatibility stack this server still expects, and the current GitHub integration lane exercises both process and Docker runtime selection around the staged server-grid export prerequisite.

Requirements

docker for the checked-in smoke/integration validation path
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6, libprotobuf10, libidn11, and libldap-2.4-2 compatibility packages)
The shared steamcmd-linux runtime image for the default validated path, or a legacy OpenSSL 1.0.x compatible host runtime for libssl.so.1.0.0 if you intentionally launch the native Linux binary outside Docker
Python packages from requirements.txt
A staged ATLAS server-grid export: ServerGrid.json, ServerGrid.ServerOnly.json, and the ServerGrid/ folder

Quick Start

Create the server:

alphagsm myatlasser create atlasserver

Run setup:

alphagsm myatlasser setup

Start it:

alphagsm myatlasser start

Check it:

alphagsm myatlasser status

Stop it:

alphagsm myatlasser stop

Support Status

atlasserver is supported in ENABLED (BYO) mode. AlphaGSM can install and launch the dedicated payload, but ATLAS still requires an operator-supplied server-grid export before start can finish booting a world.

Stage these under <install_dir>/ShooterGame/ before start:

ServerGrid.json
ServerGrid.ServerOnly.json
ServerGrid/

These files are typically generated with the official ATLAS ServerGridEditor.

Setup Details

Setup configures:

the game port (default 57555)
the query port (default 57561)
the install directory
SteamCMD downloads the server files
start still requires the staged ATLAS server-grid export under ShooterGame/

Useful Commands

alphagsm myatlasser update
alphagsm myatlasser backup

Notes

Module name: atlasserver
Default game port: 57555
Default query port: 57561

Server variables

After create atlasserver, 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
`adminpassword`	adminpass	string	Server admin password. Stored as a secret.
`serverpassword`	sv_password, password	string	Password required to join the server. Stored as a secret.

Developer Notes

Run File

Executable: ShooterGame/Binaries/Linux/ShooterGameServer
Location: <install_dir>/ShooterGame/Binaries/Linux/ShooterGameServer
Engine: Custom (SteamCMD)
SteamCMD App ID: 1006030

Smoke and integration validation track readiness through alphagsm info --json returning protocol a2s on the dedicated query port via AlphaGSM's resolved local query host instead of relying on implicit fallback routing. The checked-in validation path now opts into the module's existing steamcmd-linux Docker runtime hooks, which carry the legacy ATLAS compatibility libraries that the native Linux binary is missing on current Ubuntu 24.04 hosts.

For Docker-backed launches, AlphaGSM now mounts the shared Steam bootstrap payload into the container, runs the server as a non-root alphagsm user, and launches ShooterGameServer from ShooterGame/Binaries/Linux instead of the install root. That keeps the validated Docker runtime from depending on host-only Steam home-directory state and avoids the earlier launch-contract crash path.

Host-process launches are still available for environments that provide libssl.so.1.0.0, but they are no longer the default validation path. If you intentionally run ATLAS outside Docker on a modern host and the binary exits immediately, check for error while loading shared libraries: libssl.so.1.0.0 before debugging the AlphaGSM lifecycle itself.

If ATLAS still exits early after the grid export is staged, inspect ShooterGame/Saved/Logs/ShooterGame.log first. A missing ServerGrid.ServerOnly.json or ServerGrid/ export is now the primary known operator-side blocker, not missing Linux compatibility libraries.

Server Configuration

Config file: See game module source
Max players: 100
Template: See server-templates/atlasserver/ if available

Maps and Mods

Map directory: Check game documentation
Mod directory: Check game documentation
Workshop support: No
Current status: Supported in ENABLED (BYO) mode. Before start, generate/export ServerGrid.json, ServerGrid.ServerOnly.json, and the ServerGrid/ folder with the official ATLAS ServerGridEditor and copy them into <install_dir>/ShooterGame/.

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.

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 ATLAS?

Operator-provided prerequisites required. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Which runtimes can run ATLAS?

Declared runtimes: Docker or a Linux host process.

Which ports does ATLAS use?

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

Can I add mods to ATLAS?

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

How should I back up ATLAS?

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