Applies to: All servers · All plans
A whitelist (called an “allowlist” in Bedrock) restricts who can join your server. Only players you explicitly add can connect. Everyone else is turned away.
When to use a whitelist
Use a whitelist if you’re running a private server for friends, a community with an application process, or if you want to prevent strangers from joining your server.
Whitelist console commands
In your server’s console, use the following commands to make changes to the whitelist.
| Command | What it does |
| whitelist on | Enables the whitelist |
| whitelist off | Disables the whitelist |
| whitelist list | Lists the players that are on the whitelist |
| whitelist add <player> | Adds a player to the whitelist |
| whitelist remove <player> | Removes a player from the whitelist |
| whitelist reload | Reloads the whitelist |
Enable the whitelist
There are two ways to enable the whitelist: from the console, or manually using the File Manager.
Enable the whitelist using the console (recommended)
- Sign in to your Syrup dashboard and select your server.
- Open the console.
- Run whitelist on.
You’ll see [INFO] Turned on the whitelist in the console.
Enable the whitelist manually
- Sign in to your Syrup dashboard and select your server.
- Open the File Manager.
- Click server.properties.
- Set white-list=true.
- Click Save File.
- Restart your server. See Start, stop, or restart your server.
Add players to the whitelist
- Sign in to your Syrup dashboard.
- Select your server and open the console.
- If your server is a Java server, run whitelist add <player>. If it’s Bedrock, run: allowlist add <GamerTag>.
- Run this in the console for each player. The player doesn’t need to be online.
Remove players from the whitelist
- Sign in to your Syrup dashboard.
- Select your server.
- In the console, run whitelist remove <player>.
View the whitelist
- Sign in to your Syrup dashboard.
- Select your server.
- In the console, run whitelist list.
Or, in the File Manager, open whitelist.json and view the whitelist.
Turn off the whitelist
There are two ways to turn off the whitelist: using the console, or manually using the File Manager.
Turn off the whitelist using the console
- Sign in to your Syrup dashboard.
- Select your server.
- In the console, run whitelist off.
Turn off the whitelist manually
- Sign in to your Syrup dashboard and select your server.
- Open the File Manager.
- Click server.properties.
- Set white-list=false.
- Restart your server.
Common issues
| Problem | Fix |
| “You are not whitelisted on this server” for a player you added | Make sure whitelist is turned on and the username is spelled correctly. For Java, the player’s UUID matters. If they changed their username, remove and re-add them. |
| Whitelist isn’t enforced after enabling | Confirm enforce-whitelist=true is set in server.properties (required on some versions to kick already-connected players) |