A whitelist lets you control who can join your Valheim game server. As soon as at least one player is on the whitelist, the server only lets the listed players in—all others are blocked. This keeps your world private for you and your friends.
Valheim manages the allowed players in the permittedlist.txt file. Each entry is a Platform User ID in the format [platform]_[ID], for example Steam_76561198000000000 for Steam players. The server won’t recognize a number without a platform prefix.
You don’t need to edit the file manually: in ZapX, you can easily manage the whitelist in the dashboard. ZapX automatically adds the appropriate prefix and writes the list to the file when the server starts.
If even one player is on the whitelist, everyone else will be unable to connect. So always add yourself first.
You need the ID of every player you want to allow:
- In-game: Press
F2while on a server. The window shows the connected players and their IDs. - Steam profile: You can find the SteamID64 (17-digit number), for example, using the Steam ID Finder. Enter your Steam profile URL there and copy the "Steam64ID (Dec)".
The dashboard accepts a SteamID64 (17 digits), an Xbox XUID (16 digits) for Xbox and Microsoft Store players, or an ID already in the format Steam_<ID> or Xbox_<ID>.
- In your game server’s dashboard, open the Configuration tab.
- Scroll to the Player Management section.
- Enter the player’s ID in the search field.
- Open the new entry and check Whitelist. The change is saved immediately.
- Repeat this for every player you want to allow on your server.
- Restart your server—changes to Player Management only take effect after the next server restart.
You can also grant admin privileges in Player Management (check Admin) and ban players (check Banned). Learn more about admin commands in Valheim: Server Admin Commands & Cheats.
Find the player in Player Management, open their entry, and uncheck Whitelist. They will no longer be able to connect after the next server restart.
If you remove all players from the whitelist, the last saved permittedlist.txt file remains unchanged when the server starts—the whitelist will still be active. To disable the whitelist completely, stop the server, open permittedlist.txt in the Files tab, and delete all lines containing player IDs (you can leave the comment line starting with //), then save the file and restart the server.
After restarting, try connecting with an account that isn’t on the whitelist—the connection should be rejected. An account on the list should be able to join the server as usual. If this doesn’t work, check that the server was restarted after your last change and that you entered the correct ID.