DST Dedicated Server Guide for all platforms (Linux, Mac, Windows) with Docker.
The purpose of this project is to have DST servers up and running with the bare minimum necessary setup.
Any OS that supports Docker can run the dedicated server.
💡 Linux is the recommended OS to host the containers for better performance gains
This project was deployed and tested using Debian 9. Instructions will be focused on Linux - but it should be easy to adapt to any other OS.
These are the minimum required steps to have a server running:
Enhance your server by customizing it to your liking!
sudo apt-get install git
Follow the official docs to install Docker on Linux. At first glance it might seem complicated, but the instructions are very detailed and thorough:
👮 Make sure you have your own sudoer user and perform all the steps logged as it. Running everything as
rootuser will probably render you permissions issues down the road.
dockerwithout the need of
You only need the Docker desktop standalone as it has everything you need, no extra steps required.
Clone this repository in your home folder:
cd ~ && git clone https://github.com/mathielo/dst-dedicated-server.git
👮 Do not
sudo git cloneor your might run into permission issues 👼
See more info in Managing the Server.
⚠️ The cluster token is stored in the
DSTClusterConfig/cluster_token.txt file and without it your server won't run.
Check the detailed instructions to generate a cluster token. After you get it, make sure to delete everything from this file and leave only your cluster token there, without any spaces or anything else.
You can easily do that replacing
InsertYourTokenHere in the following command and executing it in your server:
echo 'InsertYourTokenHere' > ~/dst-dedicated-server/DSTClusterConfig/cluster_token.txt
🔐 The account that generates the token automatically gains admin access in-game, meaning you can rollback, regenerate the world or use console commands while playing.
🌈 Done! You are ready to start your server and play!
You should now have everything you need to start playing! See the full docs on how to manage your server to learn how to start, save the game and stop the server.
The files listed below are the ones you'll likely be tweaking to customize your server and world to your likes.
🚨 Changing any files other than the ones listed below is only advised if you know what you're doing.
DSTClusterConfig/ Caves/ leveldataoverride.lua Master/ leveldataoverride.lua mods/ dedicated_server_mods_setup.lua modoverrides.lua adminlist.txt blocklist.txt cluster.ini whitelist.txt
This file holds server attributes, such as
cluster_intention - and many others 🔗.
👮 Please handle with care. There are sections where
[ CHANGE THIS ]denotes places you should change. There are also smaller secitions which should not be touched as it might compromise the communication between Master <-> Caves shards.
By default the server will autosave once every game day (
autosaver_enabled = true).
Determines the settings for world generation for each shard, respectively:
You may tweak them as much as you like, granted that the cave one always have these defined:
Check the detailed instructions on how to install, configure and enable mods. 👽
If you know what you're after, the
(admin|block|white)list.txt files can be found within the
You can find detailed information and a complete guide in the Setting Admins, Bans and Whitelisted Players docs.