Set Up a Whitelist on Your 7DTD Server

A whitelist restricts your server so only approved players can join. Admins always bypass the whitelist.

How Whitelist Mode Works

• If any entry exists in the whitelist, whitelist mode activates automatically
• Non-whitelisted, non-admin players are rejected
• Admins at any permission level can always join regardless

Managing the Whitelist via Console

In the Console tab of the XGamingServer Panel:

whitelist add <SteamID64>
whitelist remove <SteamID64>
whitelist list

Example:

whitelist add 76561198012345678

Managing via serveradmin.xml

1. Click Files and open /.local/share/7DaysToDie/Saves/serveradmin.xml
2. Add entries in the <whitelist> section:

<whitelist>
  <user steamID="76561198012345678" name="TrustedPlayer1" />
  <user steamID="76561198087654321" name="TrustedPlayer2" />
</whitelist>

3. Save and restart

Whitelisting Steam Groups

You can whitelist an entire Steam group — all members get access:

<whitelist>
  <group steamID="103582791434672565" name="MyServerGroup" />
</whitelist>

The Steam group ID is different from a user's SteamID64. Find it via the group's Steam URL or steamid.io.

Disabling Whitelist Mode

Remove all entries from the <whitelist> section (or delete them via whitelist remove). With no entries, the server accepts all connections again.

📝 Note: Adding even a single whitelist entry instantly enables whitelist mode for the entire server.

Related Guides

• Admin Setup & Permissions
• Password Protect Your Server
• Server Configuration