Dark Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

Don't Starve Together dedicated server guide for all platforms (Linux, Mac, Windows) with Docker. Extensive documentation covering mods installation, server config and performance, world generation and setting up admins.

License

Notifications You must be signed in to change notification settings

mathielo/dst-dedicated-server

Repository files navigation

Don't Starve Together - Dedicated Server

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.

README in other languages

Installation

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.

Installation Overview

Essentials

These are the minimum required steps to have a server running:

  • Prepare the host
    • Install Git
    • Install Docker
  • 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.)

Optionals

Enhance your server by customizing it to your liking!

Prepare the Host

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.

Install Git

sudo apt-get install git

Install Docker

Linux

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 root user will probably render you permissions issues down the road.

Mac OS / Windows

You only need the Docker desktop standalone as it has everything you need, no extra steps required.

Prepare the dedicated server

Clone this repository in your home folder:

cd ~ && git clone https://github.com/mathielo/dst-dedicated-server.git

Do not sudo git clone or your might run into permission issues

See more info in Managing the Server.

Generate cluster_token.txt

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:

~/dst-dedicated-server/DSTClusterConfig/cluster_token.txt">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!

Manage the Server

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!

Customize the Server and World

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

The Server

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_name and cluster_password to 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).

The World

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"

Mods

Check the detailed instructions on how to install, configure and enable mods.

Admins, Bans and Whitelists

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.

Contributing

Contributions and feedback are always welcome! Feel free to open an issue or a pull request with improvements!

References

Other links

About

Don't Starve Together dedicated server guide for all platforms (Linux, Mac, Windows) with Docker. Extensive documentation covering mods installation, server config and performance, world generation and setting up admins.

Topics

Resources

Readme

License

MIT license

Stars

Watchers

Forks

Packages

No packages published

Contributors 5