A Minecraft whitelist lets you control exactly which players are allowed to join your Minecraft Java server.

This is useful for private servers, small friend groups, testing servers, staff servers, and communities that want to approve players before allowing access.

When the whitelist is enabled, only approved players can join the server.

A player who is not on the whitelist will normally be unable to connect even if they know the server address.

Down Side Hosting Minecraft servers normally use:

dsh.network:YOUR_PORT

The whitelist controls who is allowed to join that specific Minecraft server.

Log in to your Down Side Hosting server panel.

Select your Minecraft server and open:

Console

Most whitelist management can be done directly from the server console.

In the server console, enter:

whitelist on

You should receive confirmation that the whitelist has been enabled.

To allow a player to join, enter:

whitelist add PLAYERNAME

Replace PLAYERNAME with the player's Minecraft Java username.

For example:

whitelist add Steve

Once added, that player should be allowed to connect.

To remove a player:

whitelist remove PLAYERNAME

For example:

whitelist remove Steve

The player will no longer be approved by the whitelist.

To see the current whitelist:

whitelist list

Minecraft will display the players currently allowed to join.

To allow players to join without being whitelisted:

whitelist off

Be careful when disabling the whitelist on a server that is intended to remain private.

If the whitelist files were changed outside the normal Minecraft commands, you can reload them using:

whitelist reload

For normal whitelist management, using the whitelist add and whitelist remove commands is usually easier.

The whitelist can also be controlled through:

server.properties

Look for:

white-list=false

To enable it:

white-list=true

Save the file and restart the Minecraft server.

For more information about this file, see:

Minecraft server.properties Configuration Guide

Some Minecraft versions include:

enforce-whitelist=

For example:

enforce-whitelist=true

When whitelist enforcement is enabled, Minecraft can remove players who are no longer permitted by the whitelist.

For a private server, this can help ensure that whitelist changes take effect consistently.

If you have permission to manage the server in-game, you can use:

/whitelist add PLAYERNAME

For example:

/whitelist add Steve

You may need operator privileges or the appropriate permissions to use whitelist commands in-game.

From the Down Side Hosting server console, commands are normally entered without the leading slash:

whitelist add Steve

If a player receives a message saying they are not whitelisted, check:

• The Minecraft username was entered correctly
• The player was added to the correct server
• The whitelist is loaded
• The player is using the expected Minecraft account
• The server restarted or reloaded correctly if configuration files were edited manually

Use:

whitelist list

to verify the player appears.

If you added the wrong username:

whitelist remove WRONGNAME

Then add the correct one:

whitelist add CORRECTNAME

Double-check spelling before adding players.

If the player appears in:

whitelist list

but still cannot connect, the whitelist may not be the actual problem.

Check:

• Minecraft version
• Server address
• Assigned server port
• Mod or modpack compatibility
• Whether the server is fully started
• Console disconnect message

See:

How to Connect to Your Down Side Hosting Minecraft Java Server

Being whitelisted and being an operator are two different things.

Whitelist: Allows the player to join the server.

Operator: Gives the player administrative Minecraft permissions.

A player can be:

• Whitelisted but not an operator
• An operator and whitelisted
• Neither

Only give operator access to people you trust.

See:

How to Manage Minecraft Server Operators

A whitelist is especially useful for:

• Private survival servers
• Friends-and-family servers
• Staff testing servers
• Development servers
• Servers preparing before public launch
• Communities that manually approve members

For a fully public server, you may choose not to use one.

No.

A whitelist controls who can join the Minecraft server, but it does not replace:

• Strong account security
• Proper administrator permissions
• Backups
• Plugin or mod security
• Server updates
• Good server configuration

Use the whitelist as one part of your server-access controls.

From the server console:

whitelist add PLAYERNAME

Replace PLAYERNAME with the player's Minecraft username.

Use:

whitelist list

Use:

whitelist remove PLAYERNAME

Normally, no.

Whitelist commands such as:

whitelist add

take effect while the server is running.

If you manually edit configuration files, a reload or restart may be required.

Not normally.

A server administrator or someone with appropriate permissions needs to add them.

• How to Connect to Your Down Side Hosting Minecraft Server
• Minecraft server.properties Configuration Guide
• How to Manage Minecraft Server Operators
• How to Back Up a Minecraft Server

Down Side Hosting provides Minecraft Java server hosting with server panel access, file management, console controls, backups, and server configuration.

Minecraft Java hosting starts at $2/month.

View Minecraft Java Server Hosting

Contact Down Side Hosting Support

← Back to Minecraft Java Server Guides