Do you have a Linux VPS/dedicated server and want to install Hytale on it? You’re in the right place. In this guide, we’ll explain step by step how to install this service on your Linux server.
To run a Hytale server, your system must meet a few basic requirements. The server runs on Java 25 and requires at least 4 GB of RAM. Both x64 and arm64 architectures are supported. Actual resource usage depends on the number of players, view distance, and world activity, so larger servers may need additional resources.
Before continuing, make sure Java 25 is installed on your system. You can check the installation with this command:
java --version
If Java is not installed yet, follow our dedicated Java installation guide for Linux servers. It explains how to install and configure Java correctly in your environment.
Start by creating a dedicated directory for the Hytale server. This keeps all server files neatly in one place.
sudo mkdir -p /opt/hytale
sudo chown -R $(whoami):$(whoami) /opt/hytale
cd /opt/hytale
The server requires two main components: the server application itself and the game assets. You can obtain these files using the Hytale command-line downloader, which is designed specifically for server deployments and easier updates.
The CLI downloader provides a structured way to download and update the Hytale server files. After downloading the downloader archive, extract it to a temporary directory. The archive contains a QUICKSTART.md file that explains the tool’s basic features.
Run the downloader from the command line and follow the instructions to download the latest server version. Once it has finished, copy the downloaded server files and the assets archive to your server directory. The directory should then contain the server JAR file and an assets archive such as Assets.zip.
| Command | Description |
|---|---|
./hytale-downloader | Download the latest version |
./hytale-downloader -print-version | Show the game version without downloading |
./hytale-downloader -version | Show the hytale-downloader version |
./hytale-downloader -check-update | Check for hytale-downloader updates |
./hytale-downloader -download-path game.zip | Download to a specific file |
./hytale-downloader -patchline pre-release | Download from the pre-release channel |
./hytale-downloader -skip-update-check | Skip the automatic update check |
Start the server by running the JAR file and specifying the path to the assets archive. Adjust the path if your assets are located elsewhere.
java -jar HytaleServer.jar --assets /opt/hytale/Assets.zip --bind 0.0.0.0:5520
The server must be authenticated on its first launch before players can connect. This is done directly through the server console using a device-based login process. Follow the instructions in the console to complete authentication.
/auth login device
The output will look something like this:
> /auth login device
===================================================================
GERÄTE-AUTORISIERUNG
===================================================================
Besuche: https://accounts.hytale.com/device
Gib den Code ein: ABCD-1234
Oder besuche: https://accounts.hytale.com/device?user_code=ABCD-1234
===================================================================
Warte auf Autorisierung (läuft in 900 Sekunden ab)...
[User schließt Autorisierung im Browser ab]
> Authentifizierung erfolgreich! Modus: OAUTH_DEVICE
After authentication, your server can accept player connections.
By default, the server listens on UDP port 5520 and binds to all available interfaces. You can change the address and port if needed. Communication uses UDP with QUIC. Make sure your firewall allows incoming UDP traffic on the selected port, for example, using Iptables or UFW.
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
sudo ufw allow 5520/udp
View distance is one of the most important factors affecting memory usage. Higher values increase RAM requirements because more world data must remain active at the same time.
For most setups, a maximum view distance of 12 chunks (384 blocks) offers a good balance between server performance and player experience.
For comparison, Minecraft servers use a default view distance of 10 chunks (160 blocks). Hytale’s default of 384 blocks is approximately 24 Minecraft chunks, which explains the higher memory requirements. Adjust this value based on the expected number of players and available resources.
Congratulations, you now have a working Hytale server running on your system. From here, you can expand your setup by installing mods, adjusting world settings, and tuning performance parameters for your player base. We recommend regularly monitoring resource usage to ensure stable operation as your server grows.
If you have any other questions or need support, just contact our support team—we’re here for you every day! 🙂