[{"data":1,"prerenderedAt":31},["ShallowReactive",2],{"doc-en-admin-whitelist-project-zomboid-server":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":20,"docGroup":28,"docGroupIcon":28,"link_fr":29,"bodyHtml":30},"\u002Fdocs\u002Fen\u002Fgaming\u002Fproject-zomboid\u002Fadmin-whitelist-project-zomboid-server","admin-whitelist-project-zomboid-server","How to Become Admin and Make Your Project Zomboid Server Private","Become administrator of your Winheberg Project Zomboid server, use console commands and make the server private with a whitelist.","jeux","project-zomboid","tabler:file-text","2026-11-01","Winheberg",125,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fproject-zomboid\u002Fadmin-whitelist-project-zomboid-server.webp",[9,16,17,18,19],"admin","whitelist","server","gaming",[21,22,23,24,25,26,27],"project zomboid admin","project zomboid admin commands","project zomboid whitelist","private project zomboid server","setaccesslevel","adduser","server password","","\u002Fdocs\u002Fproject-zomboid\u002Fadmin-whitelist-serveur-project-zomboid","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>On a Project Zomboid server, the administrator can kick or ban players, give rights to their team, broadcast messages to the whole server or decide who is allowed to connect. On your \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fgaming\u002Fproject-zomboid\">Winheberg Project Zomboid server\u003C\u002Fa>, an administrator account is created automatically on startup from the panel variables.\u003C\u002Fp>\n\u003Cp>This guide shows you how to log in with that account, which commands to use from the panel console and how to make the server private, with a password or a whitelist.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active Project Zomboid server at Winheberg\u003C\u002Fli>\n\u003Cli>Access to the gaming panel \u003Ccode>https:\u002F\u002Fpanel.winheberg.com\u002F\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Project Zomboid on your computer to connect as administrator\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>1. Get the administrator account\u003C\u002Fh2>\n\u003Cp>In the panel, open the \u003Cstrong>Startup\u003C\u002Fstrong> tab of your server. The \u003Cstrong>ADMIN USERNAME\u003C\u002Fstrong> and \u003Cstrong>ADMIN PASSWORD\u003C\u002Fstrong> variables define the server administrator account.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fproject-zomboid\u002Fadmin-whitelist-project-zomboid-server-1793570259625-88c49a748aadefc8dff85059.webp\" alt=\"ADMIN USERNAME and ADMIN PASSWORD variables in the Startup tab\" width=\"790\" \u002F>\n\n\u003Cp>On every startup, the server creates this account if it does not exist yet, then applies the password from the variable. The console shows these lines.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">Administrator account 'admin' created.\nadmin password changed via -adminpassword option\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Replace the password with a long and unique one before opening your server to players. Anyone who knows it has full powers in game. The change applies on the next restart.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Connect in game as administrator\u003C\u002Fh2>\n\u003Cp>Launch Project Zomboid, open the multiplayer menu and add your server with its address and port, shown at the top of your server page in the panel. Then log in with the username and password set in \u003Cstrong>ADMIN USERNAME\u003C\u002Fstrong> and \u003Cstrong>ADMIN PASSWORD\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cp>Once in game, you have administrator rights. Commands are then typed in the chat, starting with a slash, for example \u003Ccode>\u002Fplayers\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>3. Use commands from the panel console\u003C\u002Fh2>\n\u003Cp>You can also manage the server without launching the game. Open the \u003Cstrong>Console\u003C\u002Fstrong> tab of the panel, with the server running, and type commands in the field at the bottom of the page, \u003Cstrong>without\u003C\u002Fstrong> a leading slash.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">players\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The \u003Ccode>help\u003C\u002Fcode> command lists every command available on your game version. Here are the most useful ones.\u003C\u002Fp>\n\u003Cdiv class=\"md-table md-table--info md-table--striped\">\u003Cdiv class=\"md-table__caption\">Common administration commands\u003C\u002Fdiv>\u003Cdiv class=\"md-table__scroll\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Command\u003C\u002Fth>\n\u003Cth>Effect\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>players\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Lists connected players\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>setaccesslevel "username" "admin"\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Gives an access level to a player, among admin, moderator, gm, observer, priority and user\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>servermsg "message"\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Broadcasts a message to all connected players\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>banuser "username"\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Bans a player, add \u003Ccode>-ip\u003C\u002Fcode> to also ban their IP address\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>unbanuser "username"\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Lifts a player's ban\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>save\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Saves the world right away\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>quit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Saves and stops the server cleanly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>For example, to give administrator rights to a team member already registered on the server, type this command. The console confirms with \u003Ccode>User Survivant is now admin\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">setaccesslevel "Survivant" "admin"\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>To remove rights, use the same command with the \u003Ccode>user\u003C\u002Fcode> level, the console then answers \u003Ccode>User Survivant is now user\u003C\u002Fcode>. Prefer the \u003Ccode>moderator\u003C\u002Fcode> level for team members who do not need full powers.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Protect the server with a password\u003C\u002Fh2>\n\u003Cp>The simplest way to restrict access is to require a password on connection. Stop the server, open the \u003Cstrong>Files\u003C\u002Fstrong> tab, then the \u003Ccode>.cache\u002FServer\u002FPterodactyl.ini\u003C\u002Fcode> file (the file name follows the \u003Cstrong>SERVER NAME\u003C\u002Fstrong> variable). Fill in the \u003Ccode>Password=\u003C\u002Fcode> line.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ini\">Password=ServerPassword\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Save with \u003Cstrong>Save Content\u003C\u002Fstrong> and restart. Players will now need this password to connect.\u003C\u002Fp>\n\u003Ch2>5. Switch the server to a whitelist\u003C\u002Fh2>\n\u003Cp>With a whitelist, only the accounts you created can connect. It is set with the \u003Ccode>Open\u003C\u002Fcode> option, near the top of the \u003Ccode>.ini\u003C\u002Fcode> file. By default it is \u003Ccode>true\u003C\u002Fcode> and anyone can create an account by connecting.\u003C\u002Fp>\n\u003Cp>The fastest way is to change it from the console, with the server running. The option applies immediately and is saved to the \u003Ccode>.ini\u003C\u002Fcode> file.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">changeoption Open "false"\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fproject-zomboid\u002Fadmin-whitelist-project-zomboid-server-1793570260699-c635bce8cbd621d4a14d0739.webp\" alt=\"Result of the changeoption Open false command in the console\" width=\"636\" \u002F>\n\n\u003Cp>You can also stop the server and edit the line directly in the file.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fproject-zomboid\u002Fadmin-whitelist-project-zomboid-server-1793570260036-3d1d292dee9c18c40c34defb.webp\" alt=\"Open line in the Pterodactyl.ini file\" width=\"790\" \u002F>\n\n\u003Cp>Then create an account for each allowed player. The player will connect with this username and password.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">adduser "Survivant" "PlayerPassword"\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The console confirms with \u003Ccode>User Survivant created with password\u003C\u002Fcode>. To remove a player from the whitelist, use \u003Ccode>removeuserfromwhitelist "Survivant"\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ The admin account does not work in game\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check that you use exactly the name and password from the \u003Cstrong>ADMIN USERNAME\u003C\u002Fstrong> and \u003Cstrong>ADMIN PASSWORD\u003C\u002Fstrong> variables.\u003C\u002Fli>\n\u003Cli>Restart the server after changing these variables, they only apply on startup.\u003C\u002Fli>\n\u003Cli>Look in the console for the \u003Ccode>admin password changed via -adminpassword option\u003C\u002Fcode> line.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ A command does nothing in the panel console\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Remove the slash in front of the command, it is only used in the in-game chat.\u003C\u002Fli>\n\u003Cli>Put usernames and values between straight quotes, as in the examples.\u003C\u002Fli>\n\u003Cli>Check that the server is running, the console accepts no command while the server is stopped.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The console answers "Access Level unknown"\u003C\u002Fh3>\n\u003Cp>The requested level does not exist. The console then lists the accepted levels.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">list of access level: banned, user, priority, observer, gm, moderator, admin\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Run the command again with one of these levels, spelled as shown.\u003C\u002Fp>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If you run into an issue with rights or access to your server, our team can help. Open a ticket from your client area \u003Ccode>https:\u002F\u002Fbilling.winheberg.com\u003C\u002Fcode> with the \u003Cstrong>Technical\u003C\u002Fstrong> department, selecting your server in the \u003Cstrong>Related Product\u003C\u002Fstrong> field. To go further, also read our guide \u003Cstrong>How to Install Mods on Your Project Zomboid Server\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cp>Your server is now in good hands 🎮\u003C\u002Fp>\n",1794353874866]