Skip to content

Dstserver

Jump to bottom
github-actions[bot] edited this page Oct 17, 2026 · 3 revisions

Don't Starve Together

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.

Clone this wiki locally