Quick answer
- Check the server is signed in:
/auth status, then/auth login device. - Hytale uses UDP (QUIC) on port 5520 by default, not TCP.
- Server and players must be on the same build; match the Patchline.
1. Authentication errors#
In the default authenticated mode the server must be signed in with a Hytale account. Run /auth status in the Console. If it isn't signed in or the token expired, run /auth login device and approve the code at accounts.hytale.com/device. The device code itself expires after 15 minutes, so approve it straight away.
2. Network and port#
- Hytale servers listen on UDP. A firewall rule for TCP only won't work.
- Self-hosting? Forward UDP 5520 (or your custom port) on your router.
- On FreeGameHost the port is already open; use the exact address and port from the top of the Console page.
3. Version mismatch#
Early Access builds update often. If the game says the server is outdated or newer, the server and players are on different builds. On FreeGameHost, check the Patchline on the Startup page (release or pre-release) matches what players run, then restart so the server updates.
4. The server crashes on start#
- Plugins for a newer build: remove recently added mods from the
modsfolder and start again. Pre-release plugins need Accept Early Plugins on. - Java: Hytale needs Java 25. Self-hosted servers on older Java fail at once.
- Corrupt world after a crash: restore a backup (on FreeGameHost: Settings → Backups, saved to your Google Drive).
5. Lag and memory#
Memory grows with view distance and with players spread out across the world. Lower the view distance first. A free FreeGameHost Hytale server has 6 GB RAM, which suits a typical community server with mods; larger worlds can move to premium.
Admin commands: Hytale server commands. Full setup: how to make a Hytale server.
Run /auth status any time to see whether the server is signed in and when its token expires. If players get an authentication error, this is the first thing to check.
Self-hosting is free, but your PC has to stay on for anyone to play, and your home upload speed limits how many players it can handle.
Option 2: a free hosted Hytale server#
On FreeGameHost the server files, Java 25 and the network are set up for you. Free Hytale servers get 6 GB RAM, 200% CPU and 10 GB of NVMe storage and run in our North America location.

- Create the server
Sign up at panel.freegamehost.xyz (no credit card), click Create Free Server, choose Hytale, the United States location and a name.
- Start it and approve the download
Press Start. On the first start the official downloader fetches the server files. If the console shows a sign-in link and code, open it and approve it with your Hytale account.
- Sign the server in
When the server has booted, type
/auth login devicein the console, approve the code ataccounts.hytale.com/device, then run/auth persistence Encrypted. - Share the address
Copy the server address from the top of the Console page and send it to your friends.
How players join#
In Hytale, open the Servers screen, add a server and enter the address. If the server doesn't use the default port, include it after a colon, for example us.freegamehost.xyz:24105. Players don't need to install anything extra, even on a modded server.
Adding mods and plugins#
Hytale mods run on the server. Put mod files into the server's mods folder (with the file manager or SFTP) and restart. Players receive the content automatically when they join.
- Download mods from trusted sources such as CurseForge and check they match your server's Hytale version.
- Some plugins load before the main server starts. Hytale asks you to accept those explicitly: on FreeGameHost, turn on Accept Early Plugins in the Startup settings.
- Add mods one at a time. If the server won't start, the last mod you added is the first suspect.
Looking for ideas? See our list of the best Hytale server mods.
How much RAM does a Hytale server need?#
RAM use grows mainly with view distance and the number of players spread out across the world. As a rough guide:
| Server | Suggested RAM |
|---|---|
| 2 to 5 friends, default settings | 4 GB |
| 5 to 15 players, a few mods | 6 to 8 GB |
| Larger communities or heavy mods | 8 GB or more, with a lower view distance |
If the server struggles, lower the maximum view radius in config.json before adding more RAM. It's the setting with the biggest effect. For bigger communities, our premium Hytale plans go up to 32 GB.
Troubleshooting#
Players can't connect#
Check that the port is open for UDP (a TCP-only rule is the most common mistake), and that players use the right port. Run /auth status to make sure the server is still signed in.
"Server session token not available"#
The server isn't signed in, or its login expired after a restart. Run /auth login device again, then /auth persistence Encrypted.
The server won't start#
Check the Java version first (java -version must show 25). If you've just added a mod, remove it and try again. On a hosted server, the console log shows the exact error.
See also: How to make a Factorio server
Frequently asked questions#
What port does a Hytale server use?
UDP 5520 by default. It uses QUIC over UDP, so TCP-only rules and forwards won't work.
Why does my Hytale server say it isn't authenticated?
It needs to be signed in with a Hytale account. Run /auth login device in the console and approve the code within 15 minutes.
Why can't friends join after an update?
Their game and the server are on different builds. Match the server's Patchline to theirs and restart.
