This guide covers the dstserver module in AlphaGSM.
dstserver 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 cluster-config prerequisite, while
local runs remain process-backed by default unless you opt into the Docker
backend.
Requirements
screen
- SteamCMD runtime libraries (
lib32gcc-s1, lib32stdc++6)
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm mydstserve create dstserver
Run setup:
alphagsm mydstserve setup
Start it:
alphagsm mydstserve start
Check it:
alphagsm mydstserve status
Stop it:
alphagsm mydstserve stop
Setup Details
Setup configures:
- the game port (default 10999)
- the install directory
- SteamCMD downloads the server files
Don't Starve Together is supported in ENABLED (BYO) mode in AlphaGSM.
The anonymous server payload installs, but startup still exits immediately
unless you provide both:
- a real
cluster_token.txt
- a real cluster config directory for the world you want to run
With the module defaults, AlphaGSM starts DST with:
-persistent_storage_root <install_dir>
-conf_dir DoNotStarveTogether
-cluster <server-name>
-shard Master
That means the expected default layout is:
<install_dir>/DoNotStarveTogether/<server-name>/
├── cluster_token.txt
├── cluster.ini
└── Master/
└── server.ini
If you change cluster, shard, or confdir with alphagsm set, place the
files under the matching adjusted path before retrying start.
Example:
alphagsm mydstserve create dstserver
alphagsm mydstserve setup
mkdir -p "<install_dir>/DoNotStarveTogether/mydstserve/Master"
## Copy your real Klei token and cluster config into that directory tree
alphagsm mydstserve start
Useful Commands
alphagsm mydstserve update
alphagsm mydstserve backup
Notes
- Module name:
dstserver
- Default port: 10999
Server variables
After create dstserver, 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:
bin64/dontstarve_dedicated_server_nullrenderer_x64
- Location:
<install_dir>/bin64/dontstarve_dedicated_server_nullrenderer_x64
- Engine: Custom (SteamCMD)
- SteamCMD App ID:
343050
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.