Skip to content

Hytale Dedicated Server Setup

Discover how to set up the Hytale Dedicated Server on your Linux Dedicated Server for seamless gameplay management → Learn more now

12 November 20263 min read45 Views0 helpful

Introduction

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.

Prerequisites

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:

Code
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.

Installation

Start by creating a dedicated directory for the Hytale server. This keeps all server files neatly in one place.

Code
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.

CommandDescription
./hytale-downloaderDownload the latest version
./hytale-downloader -print-versionShow the game version without downloading
./hytale-downloader -versionShow the hytale-downloader version
./hytale-downloader -check-updateCheck for hytale-downloader updates
./hytale-downloader -download-path game.zipDownload to a specific file
./hytale-downloader -patchline pre-releaseDownload from the pre-release channel
./hytale-downloader -skip-update-checkSkip the automatic update check

Configuration

Start the server

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.

Code
java -jar HytaleServer.jar --assets /opt/hytale/Assets.zip --bind 0.0.0.0:5520

Authentication

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.

Code
/auth login device

The output will look something like this:

Code
> /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.

Firewall configuration

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.

Code
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT
sudo ufw allow 5520/udp

Performance tips

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.

Conclusion

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! 🙂

FAQ

Frequently asked questions

Java 25 and 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.
Run java --version. If Java isn’t installed yet, see the dedicated “Java installation” guide for Linux servers.
Use the Hytale command-line downloader, designed for server deployments and easier updates. It downloads both the server application and the game assets.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.