Dedicated server guide

Empyrion - Galactic Survival

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

Recorded lifecycle pass · Support evidence: 2026-10-16.

Build setup commands

Runtime familywine-proton

Declared runtimes: Docker or a Linux host process. This module declares the Wine/Proton compatibility family.

Network bindings

Port numbers and protocols are unknown in this snapshot; review the game guide and configuration.

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

Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

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

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

Host process

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

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

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

This guide covers the empyrionserver module in AlphaGSM.

empyrionserver is currently PASSED on the documented Ubuntu 24.04 Linux baseline. The validated GitHub path is the shared Docker wine-proton runtime, with TCP query / info on port + 3. CI no longer forces the host-Proton lane that exited before readiness in the full 2026-07-16 run.

Requirements

Docker for the validated Linux runtime
Wine or Proton-GE plus screen only for an operator-selected process runtime
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myempyrion create empyrionserver

Run setup:

alphagsm myempyrion setup

Start it:

alphagsm myempyrion start

Check it:

alphagsm myempyrion status

Stop it:

alphagsm myempyrion stop

Setup Details

Setup configures:

the game port (default 30000)
the derived TCP status port (queryport, default port + 3)
the install directory
SteamCMD downloads the Windows dedicated server files
when dedicated.yaml exists, AlphaGSM syncs the configured game port into ServerConfig.Srv_Port during install, update, set port, and pre-start

Useful Commands

alphagsm myempyrion update
alphagsm myempyrion backup

Notes

Module name: empyrionserver
Default game port: 30000
Default stored queryport: port + 3 (30003 by default)
AlphaGSM query, info, and info --json use the live STCP TCP listener on port + 3
Upstream dedicated.yaml still documents 30004 as Tel_Port; AlphaGSM does not rely on that fixed legacy value for runtime readiness

Server variables

After create empyrionserver, 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: DedicatedServer/EmpyrionDedicated.exe
Location: <install_dir>/DedicatedServer/EmpyrionDedicated.exe
Linux launch shape: DedicatedServer/EmpyrionDedicated.exe -batchmode -nographics -logFile Logs/alphagsm-dedicated.log -dedicated dedicated.yaml
Engine: Windows dedicated server via Wine/Proton
SteamCMD App ID: 530870

Current Linux validation no longer uses EmpyrionLauncher.exe, because the launcher exits after spawning the real dedicated child and tears down the temporary display with it. AlphaGSM keeps the direct dedicated binary as the runtime-neutral module contract, and the module syncs ServerConfig.Srv_Port in dedicated.yaml from the AlphaGSM-owned port value. Focused Linux validation on 2026-05-29 proved the live runtime/query surface:

AlphaGSM syncs ServerConfig.Srv_Port from the owned game port into dedicated.yaml
the live AlphaGSM readiness/query/info surface is the generic TCP STCP listener on port + 3, which Empyrion logs as STCP: Now listening for PfServers on port <port + 3>
query, info, and info --json now use that derived TCP listener instead of the older stale fixed-30004 / A2S assumption
integration readiness polls that AlphaGSM info surface directly, so Docker validation does not depend on a host-owned log file

EmpyrionLauncher.exe -startDedi remains intentionally unused on Linux because the launcher exits after spawning a detached child and tears down the temporary display with it. The supervised direct dedicated binary in Docker remains the supported AlphaGSM contract.

Server Configuration

Config files: dedicated.yaml
Template: See server-templates/empyrionserver/ if available

Maps and Mods

Map directory: Check game documentation
Mod directory: Check game documentation
Workshop support: No

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 Empyrion - Galactic Survival?

Recorded lifecycle pass. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Which runtimes can run Empyrion - Galactic Survival?

Declared runtimes: Docker or a Linux host process. This module declares the Wine/Proton compatibility family.

Which ports does Empyrion - Galactic Survival use?

Port numbers and protocols are unknown in this snapshot; review the game guide and configuration.

Can I add mods to Empyrion - Galactic Survival?

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

How should I back up Empyrion - Galactic Survival?

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