Skip to main content

How to Configure Project Zomboid Server Password & Whitelist

To keep your server safe from prank players (griefers), loot thieves, or base destroyers, you can lock your server so only certain people can join.

In Project Zomboid, there are 2 security methods:

  1. Server Password: The simplest method for playing together with friends (just enter one server password when joining).
  2. Whitelist System (Open=false): A strict method for communities or Roleplay servers (the admin must register each player's account one by one via the console).

Choose the method that best fits your needs below!


Method 1: Setting a Server Password (Simplest)​

If you just want a private session with your close friends:

  1. Log in to the Raznar Game Panel.
  2. Enter your server, click the "Files" menu, open the .cache folder, then go into the Server folder.
  3. Open the Pterodactyl.ini file.
  4. Find the Password= line (usually located in the early lines).
  5. Enter the password you want right after the equals sign:
    Password=mabarzomboid123
  6. Click "Save File" in the bottom right corner.
  7. Open the Console menu, then click Restart.
  8. Now, every friend who wants to join must enter that password in the "Server Password" field when connecting in the in-game menu.

Method 2: Enabling the Whitelist System (Secure & Strict)​

The Whitelist system prevents strangers from creating new accounts freely on your server.

Step 1: Disable Public Registration (Open=false)​

  1. Open the Pterodactyl.ini file again in the .cache/Server/ folder.
  2. Find the Open=true line.
  3. Change its value to:
    Open=false
  4. Click "Save File" then Restart your server.
WHAT DOES OPEN=FALSE MEAN?

When Open=true, anyone who connects will automatically have a new account created in the server database. By changing it to Open=false, the server will only accept players whose data has been registered manually by the admin.


Step 2: Add Player Accounts to the Server​

After the server is running with Open=false, you need to register your friends:

  1. Open the Console tab in the Game Panel.
  2. Enter the following command in the console field:
    adduser "PlayerName" "AccountPassword"

    🔧 Example:

    adduser "BudiSantoso" "Budi12345"
  3. Press Enter. The console will confirm that the account was created successfully.
  4. Give that username and password to the player so they can use it to log in to the server.

Account Management Commands in the Console​

Here are some additional commands in the Console tab for managing whitelisted players:

CommandFunctionExample
adduser "User" "Pass"Register a new player accountadduser "Andi" "AndiPass"
removeuser "User"Remove a player account from the serverremoveuser "Andi"
changeaccountpassword "User" "NewPass"Change the password if a player forgets itchangeaccountpassword "Andi" "New123"
SECURITY TIP

Avoid using spaces or complicated special characters in account usernames to prevent bugs when verifying player save data.