How can I make sure all whitelist slots are usable?

The number of IDs in whitelist.txt should be at least equal to the Whitelist Slots value. Otherwise, you may run into join issues if more slots are reserved than there are players on the list.

Don't Starve Together: Whitelist

Learn how to whitelist your Don't Starve Together game server at ZAP-Hosting → Find out more now

10 November 20262 min read3 Views0 helpful

Introduction

A whitelist is an access list that restricts who can join your server. In Don't Starve Together, it is implemented as an allowlist based on Klei User IDs. On your server with us, it consists of the whitelist.txt file and the Whitelist Slots setting in your game server panel.

Enable the whitelist

Connect to your server via FTP and open the DoNotStarveTogether/Cluster_1/ folder. Create or edit the whitelist.txt file there. Add one Klei ID in KU_ format per line.

txt

KU_aaaaaaaa
KU_bbbbbbbb

Then set how many player slots are reserved for players on the whitelist:

In your game server management panel, open the Configuration tab.
Select the Startup parameters category.
Set Whitelist Slots to the number of reserved slots. If only whitelisted players should be able to join, use the same value as Max. players. A higher value is automatically limited to the player count, while 0 disables the whitelist.
Click Save.
Restart the server. The setting and whitelist.txt are read when the server starts.

Info

Do not add whitelist_slots to cluster.ini yourself. The file is rewritten every time the server starts, and the value comes from the Whitelist Slots setting.

Manage whitelisted players

To add a player, add their KU_ ID to whitelist.txt, save the file, and restart the server.

To remove a player, delete their KU_ ID from whitelist.txt, save the file, and restart the server.

Make sure whitelist.txt contains at least as many IDs as the number of Whitelist Slots you have set. Otherwise, you may run into join issues if more slots are reserved than there are players on the list.

Check that the whitelist is working

After restarting the server, try joining with an account that is not listed in whitelist.txt. If Whitelist Slots is set to the same value as Max. players, the join attempt should fail. Then test whether access works with a listed KU_ ID.

If the server still lets unlisted players join, check that whitelist.txt is in the DoNotStarveTogether/Cluster_1/ folder and that Whitelist Slots has been saved and is greater than 0. Then restart the server again.

Conclusion

If you have followed all the steps correctly, your whitelist is now active and you can control exactly who can join the server. If access still does not work as expected, restart the server and check the files or the output to make sure the change has been applied.

FAQ

Frequently asked questions

It is based on Klei User IDs (KU_ format) and consists of the whitelist.txt file in the DoNotStarveTogether/Cluster_1/ folder and the Whitelist Slots setting in the game server panel (Configuration > Startup parameters).

In the panel, go to Configuration > Startup parameters and set Whitelist Slots to the same value as Max. players. Then restart the server. Only listed players will be able to join.

Add their Klei ID in KU_ format as a new line in whitelist.txt, save the file, and restart the server.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.