This guide covers the subnauticaserver module in AlphaGSM.
subnauticaserver 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 owned-client-install
prerequisite, while local runs remain process-backed by default unless you opt
into the Docker backend.
Requirements
screen
- An owned Subnautica client installation path for Nitrox to inspect
- Nitrox currently looks for a configured game path or the
SUBNAUTICA_INSTALLATION_PATH environment variable
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm mysubnauti create subnauticaserver
Run setup:
alphagsm mysubnauti setup
Start it:
alphagsm mysubnauti start
Check it:
alphagsm mysubnauti status
Stop it:
alphagsm mysubnauti stop
Setup Details
Setup configures:
- the game port (default 11000)
- the install directory
- downloads and extracts the server archive
This server is supported in ENABLED (BYO) mode. Before start, provide Nitrox with a real owned Subnautica installation path.
On the current Linux lane, the missing .NET runtime is no longer the blocker;
startup now aborts only when Nitrox cannot find the base game files.
Useful Commands
alphagsm mysubnauti update
alphagsm mysubnauti backup
Notes
- Module name:
subnauticaserver
- Default port: 11000
Server variables
After create subnauticaserver, 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:
Nitrox.Server.Subnautica
- Location:
<install_dir>/Nitrox.Server.Subnautica
- Engine: Custom
- Owned client path required before start: set Nitrox's game path or
SUBNAUTICA_INSTALLATION_PATH to a real Subnautica install
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.