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:
- Prepare the host
- Setup the server
- Server files (clone this repository)
- Generate
cluster_token.txt
- Manage the server (how to start, save and stop)
- Basic settings setup (server name, password, etc.)
Enhance your server by customizing it to your liking!
- Customize your server
- Tweak server settings (game mode, max players, Steam Group, description, etc.)
- World Settings (World Size, Seasons, Difficulty, etc)
- Install Mods
- Set Admins, Bans and Whitelisted Players
- How to optimize your DST Server Performance
Read about server performance for useful tips to make the best use of your resources! That might also help you to pick a host machine if you're unsure about it.
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.
- Docker Engine CE
- Docker Compose
- IMPORTANT: Read through and follow the 👉 post-installation steps for Linux 👈
- Enable your user to manage
dockerwithout the need ofsudo - Configure Docker to start on boot
- Enable your user to manage
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.
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.
Keep on reading to learn how to 👇 customize the server 👇 and install mods to your liking!
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 max_players, pause_when_empty, cluster_intention - and many others 🔗.
💡 On your first setup it's important to change at least the
cluster_nameandcluster_passwordto be able to identify and join your sever from the game's server list.
👮 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:
id="DST_CAVE"
location="Cave"
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 DSTClusterConfig/ folder.
You can find detailed information and a complete guide in the Setting Admins, Bans and Whitelisted Players docs.
Contributions and feedback are always welcome! Feel free to open an issue or a pull request with improvements!
