Dedicated server guide

GRAV

Manage gravserver 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

peerport/UDP, peerport/TCP, queryport/UDP, queryport/TCP, 7777/UDP, 7777/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-gravserver create gravserver
Complete interactive setup ./alphagsm-docker my-gravserver setup
Start the game server ./alphagsm-docker my-gravserver start
Check the instance status ./alphagsm-docker my-gravserver status

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

Host process

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

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

This guide covers the gravserver module in AlphaGSM.

gravserver 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 staged-server prerequisite, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

screen
an owned GRAV dedicated server tree staged locally
On Linux, Wine and xvfb-run. The dedicated server is the Win32 build shipped inside the owned Steam game (app 332500). There is no separate Linux dedicated-server archive. Anonymous SteamCMD does not mount a depot. A local process start with a saved profile answered A2S on UDP 41002 (hostname lagrav, map Reborn Update 9.8.1, 0/255). The game port was 41000 and the peer port was 41001. The process was stopped and those UDP ports were free. Docker was not run. The default query port 27015 was already taken.
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mygravserv create gravserver

Run setup:

alphagsm mygravserv setup

GRAV is supported in ENABLED (BYO) mode in AlphaGSM. Before setup or start, stage an owned GRAV Windows tree so <install_dir>/Binaries/Win32/CAGGameServer-Win32-Shipping.exe exists. AlphaGSM also accepts CAGGameServer-Win32-Shipping at the install root.

Start it:

alphagsm mygravserv start

Check it:

alphagsm mygravserv status

Stop it:

alphagsm mygravserv stop

Setup Details

Setup configures:

the game port (default 7777)
the install directory

Suggested flow:

alphagsm mygravserv create gravserver
alphagsm mygravserv setup -n 7777 /path/to/gravserver
## stage the owned Steam tree, including Binaries/Win32/CAGGameServer-Win32-Shipping.exe
alphagsm mygravserv start

Useful Commands

alphagsm mygravserv update
alphagsm mygravserv backup

Notes

Module name: gravserver
Default game port: 7777
Default peer port: 7778
query and info use Steam A2S on the dedicated queryport (default 27015), not the game port.
Linux launches Binaries/Win32/CAGGameServer-Win32-Shipping.exe from Binaries/ with Wine under Xvfb (prefer_proton is off). The Docker runtime family stays steamcmd-linux.
SteamCMD app 332500 is the owned GRAV install. Anonymous login may mount no depot. A saved Steam auth profile is passed to SteamCMD only when steam_auth_profile is set, and that session does not fall back to anonymous.

Server variables

After create gravserver, 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.

Developer Notes

Run File

Executable: CAGGameServer-Win32-Shipping.exe
Location: <install_dir>/Binaries/Win32/CAGGameServer-Win32-Shipping.exe
Working directory: <install_dir>/Binaries/
Engine: Custom

Server Configuration

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

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.

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

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

Which runtimes can run GRAV?

Declared runtimes: Docker or a Linux host process.

Which ports does GRAV use?

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

Can I add mods to GRAV?

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

How should I back up GRAV?

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