Skip to main content
To enable a whitelist on your FREAKHOSTING Hytale server, open Game settings in the Game Panel, turn on Joining needs permission in the Server section, click Review and save, then Save changes, and restart. Only players with the join permission can then enter. The server keeps the list of allowed players in whitelist.json in its main folder.

​
Before you start

  • Your server must have started once, so config.json exists. If Game settings shows config.json does not exist yet, see getting started.
  • Have the exact Hytale usernames of the players you want to allow.

​
What is a whitelist?

A whitelist is a list of players who may join. When it is on, everyone else is refused, even if they know the address. Use it for a private server with a fixed group of players.

​
How to turn on the whitelist

1

Open Game settings

Open your server in the Game Panel and click Game settings under GAME SETTINGS.
2

Turn on Joining needs permission

In the Server section, switch on Joining needs permission. The panel describes it as “Only players with the join permission can enter (a whitelist).”
3

Review and save

Click Review and save, check the change and click Save changes.
4

Restart

Click Restart now. The whitelist is active when the server is back.
To turn it off again, switch off Joining needs permission, save and restart.

​
How to add players to the whitelist

The allowed players are stored in whitelist.json in the server’s main folder. The Game Panel has no page to add names to it yet. Open a ticket with the Hytale usernames you want to allow, and our team adds them for you.
If you edit whitelist.json yourself in Files, stop the server first and make a backup. Hytale rewrites its config files while it runs, so changes made while it is running are likely to be overwritten.

​
Whitelist or password: which should I use?

You can use both. See server password.

​
Frequently asked questions

​
Where is the Hytale whitelist file?

whitelist.json, in the server’s main folder. Open Files in the Game Panel to see it.

​
Why can a player still join after I turned the whitelist on?

The setting applies after a restart. Restart the server, then try again.

​
Do I need to add myself to the whitelist?

Include yourself in the list of players you send us, so you are not locked out.

​
Can I ban a player instead?

Yes. Hytale keeps banned players in bans.json. Open a ticket if you need help with a ban.

Hytale server guide

Every Hytale page in one place.

Server password

One password for everyone.

Add an admin

Operators and permissions.

Server settings explained

Every Game settings option.

File Manager

Edit and back up files.
Checked against the official Hytale Server Manual on 3 November 2026; panel steps tested on our Game Panel on 3 November 2026 (Hytale server, Game settings and Startup pages). Steps may differ slightly if the game changes.

​
Need Extra Help?

If you encounter any issues, our support team is ready to assist:

​
Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!
Last Updated: November 2026