# How to Set Up a Whitelist on Your 7 Days to Die Server (/docs/7-days-to-die/whitelist)



import { Step, Steps } from 'fumadocs-ui/components/steps';

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

How Whitelist Mode Works [#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 [#managing-the-whitelist-via-console]

In the **Console** tab of the [XGamingServer Panel](https://panel.xgamingserver.com):

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

Example:

```
whitelist add 76561198012345678
```

Managing via serveradmin.xml [#managing-via-serveradminxml]

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

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

3. Save and restart

Whitelisting Steam Groups [#whitelisting-steam-groups]

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

```xml
<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](https://steamid.io/).

Disabling Whitelist Mode [#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 [#related-guides]

* [Admin Setup & Permissions](/docs/7-days-to-die/admin-setup)
* [Password Protect Your Server](/docs/7-days-to-die/server-password)
* [Server Configuration](/docs/7-days-to-die/server-config)