How to Start a Hytale Server (Windows, macOS, Linux & Dedicated Server Guide)

BitaceS · Feb 10, 2026

How to Start a Hytale Server

Windows, macOS, Linux & Dedicated Server Guide

Starting your own Hytale server is easier than you might think.
This guide walks you through the setup for all major systems, plus a dedicated server setup.

Even if you have never hosted a server before, you can follow this step by step.

Official documentation:
Hytale Server Manual

System Requirements

Minimum requirements:

4 GB RAM
64-bit system
Java 25 installed
UDP port 5520 open

Download Java (Adoptium):
[Adoptium]

Check installation:

Code:

java --version

You should see something like:

Code:

openjdk 25.x.x

Where to Get the Server Files

You have two options.

Option 1: Copy files from the Hytale launcher

Windows:

Code:

%appdata%\Hytale\install\release\package\game\latest

Linux:

Code:

$XDG_DATA_HOME/Hytale/install/release/package/game/latest

macOS:

Code:

~/Library/Application Support/Hytale/install/release/package/game/latest

Copy these files:

HytaleServer.jar
Assets.zip

Windows Server Setup

1. Install Java (Adoptium)

Download:
[Adoptium]

Install Java 25 and verify:

Code:

java --version

2. Create server folder

Open PowerShell:

Code:

mkdir C:\HytaleServer
cd C:\HytaleServer

Copy:

HytaleServer.jar
Assets.zip

3. Start the server

Code:

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip

Authenticate:

Code:

/auth login device

4. Open firewall port

Code:

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

macOS Server Setup

1. Install Java (Adoptium)

Download Java 25:
[Adoptium]

Verify:

Code:

java --version

2. Create server folder

Code:

mkdir ~/HytaleServer
cd ~/HytaleServer

Copy server files and start:

Code:

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip

Authenticate:

Code:

/auth login device

Linux Server Setup

1. Install Java 25 (Adoptium)

Code:

sudo apt update
sudo apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor > /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update
sudo apt install temurin-25-jre -y

Verify:

Code:

java --version

2. Create server folder

Code:

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

3. Start the server

Code:

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip

Open firewall:

Code:

sudo ufw allow 5520/udp

Dedicated Server Setup (Ubuntu / Debian)

For production servers, it is strongly recommended to run Hytale inside a `screen` session so it keeps running after you disconnect from SSH.

Recommended specs:

2–4 CPU cores
4–8 GB RAM
SSD or NVMe storage

1. Connect via SSH

Code:

ssh root@your-server-ip

2. Update system

Code:

apt update && apt upgrade -y

3. Install Java 25 (Adoptium)

Code:

apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor > /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" > /etc/apt/sources.list.d/adoptium.list
apt update
apt install temurin-25-jre -y

Verify:

Code:

java --version

4. Create server user

Code:

adduser hytale
su - hytale
mkdir ~/hytale-server
cd ~/hytale-server

Upload:

HytaleServer.jar
Assets.zip

5. Install and use screen

Install screen:

Code:

sudo apt install screen -y

Start a screen session:

Code:

screen -S hytale

You are now inside the screen session.

6. Start the server

Code:

cd ~/hytale-server
java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip

Authenticate:

Code:

/auth login device

Detach from screen

Press:

Code:

CTRL + A, then D

The server will continue running in the background.

Reattach later

Code:

screen -r hytale

Basic Security Tips

Never run the server as root
Only open UDP port 5520
Enable automatic backups
Keep the server updated
Use strong admin credentials

Search

Countdown until official launch!

How to Start a Hytale Server (Windows, macOS, Linux & Dedicated Server Guide)