Skip to main content

Whitelisting Your Server

A whitelist restricts who can join your server to a list of approved players. It's the simplest way to keep a server private for you and your friends.

Turning the Whitelist On

Run the following command in-game or from the console:

/whitelist on

Once enabled, only players on the whitelist can connect. To turn it back off, use /whitelist off.

Managing the Whitelist

CommandWhat it does
/whitelist add <username>Adds a player to the whitelist.
/whitelist remove <username>Removes a player from the whitelist.
/whitelist listShows everyone currently whitelisted.
/whitelist reloadReloads the whitelist from disk after editing whitelist.json manually.

Whitelisted players are stored in the whitelist.json file in your server folder.

tip

Operators can always join, even when they're not on the whitelist. If you want to enforce the whitelist strictly, kicking non-whitelisted players the moment they're removed, set enforce-whitelist=true in server.properties.