What does "You are not white-listed on this server!" mean?

The whitelist is turning players away. white-list=true and the account trying to join is not on the list. This is the usual reason an owner cannot join their own freshly installed server. Add the account from the console with "whitelist add ", exactly as the account is spelled, then "whitelist reload". To open the server up instead, set white-list=false in server.properties and restart. Bedrock players joining through Geyser need their Floodgate name (with its prefix) on the list, not their Java name.

How do I fix "You are not white-listed on this server!"?

1. Add the account from the console: whitelist add , spelled exactly as the Minecraft account. The server looks the name up and stores the UUID, so a typo adds a stranger or nobody. 2. Reload: whitelist reload if you edited whitelist.json by hand. The command form applies immediately. 3. Bedrock players through Geyser: Their name on the whitelist is the Floodgate name, prefix included (the default prefix is a full stop), not their Java name. 4. Or turn the whitelist off: white-list=false in server.properties and restart, if the server is meant to be open.

Roastd / Minecraft

warning

The whitelist is turning players away

What it looks like in your log

You are not white-listed on this server!

What causes it

white-list=true and the account trying to join is not on the list. This is the usual reason an owner cannot join their own freshly installed server.

How to fix it

Add the account from the console with "whitelist add <name>", exactly as the account is spelled, then "whitelist reload". To open the server up instead, set white-list=false in server.properties and restart. Bedrock players joining through Geyser need their Floodgate name (with its prefix) on the list, not their Java name.

Why it happens

white-list=true in server.properties means only accounts on whitelist.json can join. Everyone else is refused with this message before they see the world. It is the most common reason an owner cannot join a server they just set up: many hosts enable the whitelist by default, and the owner is not on it yet.

The match is on the account, not the display name. A player who changed their Minecraft name is still the same UUID, but a name typed wrongly into the whitelist command matches nobody.

Fix it step by step

1Add the account from the consolewhitelist add <name>, spelled exactly as the Minecraft account. The server looks the name up and stores the UUID, so a typo adds a stranger or nobody.
2Reloadwhitelist reload if you edited whitelist.json by hand. The command form applies immediately.
3Bedrock players through GeyserTheir name on the whitelist is the Floodgate name, prefix included (the default prefix is a full stop), not their Java name.
4Or turn the whitelist offwhite-list=false in server.properties and restart, if the server is meant to be open.

If that didn't work

If the account is on the list and still refused, the server is in offline mode or behind a proxy that is not forwarding identities, so the UUID the server sees is not the one on the list. The offline-mode page covers it.

Not sure this is your problem? Paste your log and Roastd will tell you which of these it actually matched, and what else it found.

Check your own log