GuavaHost
Language & currency
Client AreaGame Panel Toggle navigation
Navigation
PricingReviewsHelp CenterSupport
Games All Games
Minecraft Java $3.99/mo
Minecraft Bedrock $3.99/mo
Minecraft Geyser $3.99/mo
Rust $15.99/mo
RuneScape: Dragonwilds $5.99/mo
Palworld $9.99/mo
Valheim $5.99/mo
Valheim + BepInEx $5.99/mo
ARK: Survival Evolved $11.99/mo
ARK: Survival Ascended $17.99/mo
Project Zomboid $5.99/mo
Enshrouded $5.99/mo
Don't Starve Together $2.99/mo
7 Days to Die $12.99/mo
Counter-Strike 2 $2.99/mo
Terraria $2.49/mo
tModLoader $2.49/mo
Hytale $11.99/mo
Multi-Game Server $24.99/mo
Discord Bot Hosting $1.50/mo
Company
About UsFAQRefer to earnSLATerms of ServicePrivacy Policy
Language & currency
Client AreaGame Panel

Set Up a Minecraft Whitelist Without Locking Yourself Out

A whitelist limits your server to an approved list of players, and the trick to enabling it safely is to add yourself and your admins to the list before you turn it on.

2 min read · Updated Aug 18, 2026 · By GuavaHost Team

What a whitelist does

With the whitelist on, only names on the approved list can connect. Everyone else is refused at the login screen. It is the simplest way to keep a private server private, whether it is just for friends or a paid community.

One important detail: the moment you enable a whitelist, anyone not on it is kicked, including you if you forgot to add yourself. That is how people lock themselves out, so follow the order below.

The safe order to turn it on

Do this from the Console tab so you always have access, even if you are not currently in-game.

  1. Add yourself: whitelist add YourUsername.
  2. Add your admins and friends, one per line: whitelist add FriendName.
  3. Double check the list: whitelist list.
  4. Only now turn it on: whitelist on.

You can also flip white-list=true in server.properties, but adding names first from the Console is safer because the Console always works regardless of the whitelist.

If you lock yourself out

Do not panic, the Console bypasses the whitelist completely:

  1. Open the Console tab.
  2. Run whitelist add YourUsername.
  3. Run whitelist reload.
  4. Try connecting again.

If you prefer, you can edit whitelist.json directly on the Files tab. It is a list of player names and UUIDs. Add an entry, save, and run whitelist reload in the Console.

Ops and a few gotchas

  • Server operators can be set to ignore the whitelist, but do not rely on that. Add yourself to the list properly.
  • Names are tied to Mojang accounts, so a player who changes their username keeps access thanks to their stored UUID.
  • Keep online-mode=true. Whitelisting depends on verified accounts to match names to UUIDs correctly.
  • To remove someone, run whitelist remove PlayerName.

Running Bedrock instead?

Bedrock Edition calls this feature the allowlist and sets it up a little differently. If your GuavaHost server is Bedrock, see our separate allowlist guide for the exact steps.

Take a quick Backups snapshot before your first public opening so you can restore if a setting goes wrong.

Still stuck? Jump into our Discord at discord.gg/GuavaHost and the team will help you out.

  • whitelist
  • security
  • admin
  • java

Host a Minecraft Java server From $3.99/mo, with instant setup and DDoS protection.

Still need help? Our team is online 24/7 to answer questions.

Contact support

Related guides

More from Minecraft: Java.

  • Anti-cheat on a Minecraft server: what works

    What cheat clients actually do, what a server-side anti-cheat can and cannot detect, how to keep false positives from punishing honest players, and why logging and moderation catch more cheaters than any plugin on its own.

    6 min

  • How to Op Yourself and Run Admin Commands on Minecraft

    Giving yourself operator (op) status makes you a server admin, unlocking cheat and moderation commands like /gamemode, /give, /tp and /ban that normal players cannot use.

    2 min

  • Set Up Permissions With LuckPerms on Minecraft

    LuckPerms is the most popular permissions plugin for Minecraft servers, letting you create ranks and control exactly which commands and features each group of players can use.

    2 min

  • Installing plugins on Minecraft Java

    Add plugins to your Minecraft Java server on GuavaHost from the Plugins page in your control panel, or by uploading the .jar file yourself.

    3 min

  • Installing a modpack on Minecraft Java

    Install a modpack on your Minecraft Java server from the Modpack page in your control panel, and understand why every player needs the exact same pack to join.

    3 min