How to Create a Hytale Dedicated Server

This guide walks you through setting up a Hytale dedicated server from scratch. Whether you’re hosting for friends or running a public server, follow these steps to get started.

Prerequisites

• Java 25: Hytale requires Java 25 (see our Java 25 Installation Guide)
• 4 GB RAM minimum: More for larger player counts
• Hytale Game License: Required for authentication
• Server Files: Downloaded via Hytale Downloader CLI or copied from launcher

Step 1: Install Java 25

Download and install Java 25 from Adoptium.

Verify installation:

java --version

Expected output:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)

Step 2: Get Server Files

Option A: Hytale Downloader CLI (Recommended)

./hytale-downloader
unzip game.zip -d server/

Option B: Copy from Launcher

Copy the Server folder and Assets.zip from:

• Windows: %appdata%\Hytale\install\release\package\game\latest
• Linux: $XDG_DATA_HOME/Hytale/install/release/package/game/latest

Step 3: Start the Server

java -jar HytaleServer.jar --assets PathToAssets.zip

The server will start and prompt for authentication.

Step 4: Authenticate the Server

In the server console, run:

/auth login device

Follow the on-screen instructions to authorize via your browser.

Step 5: Configure Firewall

Hytale uses QUIC over UDP port 5520 (default).

Windows

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

Linux

sudo ufw allow 5520/udp

Step 6: Port Forwarding (Home Hosting)

If hosting at home, forward UDP port 5520 on your router to your server’s local IP.

Server is Ready

Share your public IP and port with players:

your.public.ip:5520

Useful Launch Options

Example Startup Script

#!/bin/bash
java -Xms4G -Xmx8G \
  -XX:AOTCache=HytaleServer.aot \
  -jar HytaleServer.jar \
  --assets ../Assets.zip \
  --backup