How to Run a Hytale Server on Ubuntu 22.04

Want to host your own Hytale server? Here's how to get it running on Ubuntu 22.04.

What You Need

• Ubuntu Server 22.04 LTS
• At least 4 GB RAM (8 GB+ recommended)
• 64-bit CPU
• Java 25
• UDP port 5520 open

Step 1: Update Your System

Run updates first. Saves headaches later.

sudo apt update && sudo apt upgrade -y

Step 2: Install Java 25

Hytale needs Java 25. Older versions won't work.

sudo apt install openjdk-25-jdk -y

Check it installed:

java --version

Step 3: Create a Server Folder

Keep things organized.

mkdir ~/hytale-server
cd ~/hytale-server

Step 4: Get the Hytale Downloader

Download the official tool:

wget https://downloader.hytale.com/hytale-downloader.zip
sudo apt install unzip -y
unzip hytale-downloader.zip
chmod +x hytale-downloader

Step 5: Download Server Files

Run the downloader:

./hytale-downloader-linux-amd64

It'll ask you to visit a URL and enter a code. Do that, then extract what it downloads:

unzip 2026.01.13-50e69c385.zip

You'll get a Server/ folder and Assets.zip.

Step 6: Start the Server

cd Server
java -jar HytaleServer.jar --assets Assets.zip

Wait for it to fully boot before the next step.

Step 7: Authenticate

Required. Run this in the server console:

/auth login device

Follow the link, log in with your Hytale account, enter the code. Server won't accept players until this is done.

Step 8: Open the Firewall

Hytale uses UDP, not TCP.

sudo ufw allow 5520/udp
sudo ufw reload

If you're behind a router, forward UDP port 5520 to your server's local IP.

Step 9: Give It More RAM (Optional)

Java won't use all your RAM unless you tell it to.

java -Xms8G -Xmx8G -jar HytaleServer.jar --assets Assets.zip

-Xms = starting memory. -Xmx = maximum memory.

Rough guide:

• Small server: 4 GB
• Medium: 6-8 GB
• Large/public: 10-16 GB

Leave 1-2 GB for the OS.

Step 10: Keep It Running After Logout

Use screen so the server stays up when you disconnect SSH:

sudo apt install screen -y
screen -S hytale

Start the server in screen. Detach with CTRL + A, then D. Reconnect later:

screen -r hytale

Done

Players can connect now. Server address is your public IP on port 5520.