GameServerGuides
    Back to Setup Guides
    Linux

    Hytale Server Setup on Linux

    Complete guide to installing and running a Hytale dedicated server on Linux using Java 25 and the Hytale Downloader.

    1Install Java 25 LTS

    Hytale requires Java 25 LTS. Install Adoptium Temurin on Ubuntu/Debian:

    # Add Adoptium repository
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -
echo "deb https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

# Install Java 25
sudo apt update
sudo apt install temurin-25-jdk -y

# Verify installation
java --version

    You should see output like: openjdk 25.0.1 2025-10-21 LTS

    2Get the Hytale Downloader

    The Hytale Downloader CLI is the recommended method for production servers and easy updates.

    # Create server directory
mkdir -p ~/hytale-server && cd ~/hytale-server

# Download the Hytale Downloader
wget https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip

# Rename for convenience and make executable
mv hytale-downloader-linux-amd64 hytale-downloader
chmod +x hytale-downloader

    Hytale Downloader Commands

    • ./hytale-downloader - Download latest version
    • ./hytale-downloader -print-version - Show game version
    • ./hytale-downloader -check-update - Check for updates

    3Download Server Files

    Run the downloader to get the latest server files.

    # Download the latest server files
./hytale-downloader

# This will download:
# - Server/HytaleServer.jar
# - Server/HytaleServer.aot
# - Assets.zip

    4First Server Launch

    Start the server for the first time.

    cd ~/hytale-server/Server
java -Xms4G -Xmx8G -jar HytaleServer.jar --assets ../Assets.zip

    Performance Tip

    For faster startup after first run, use AOT caching:

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

    5Authenticate Your Server

    Hytale servers must be linked to your account. Each account can create up to 100 servers.

    /auth login device
    1. A code will be displayed (e.g., ABCD-1234)
    2. Go to accounts.hytale.com/device
    3. Enter the code and authorize

    6Configure Firewall

    Open UDP port 5520 for the Hytale server.

    # Using UFW (Ubuntu/Debian)
sudo ufw allow 5520/udp

# Or using iptables
sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

    Note

    Hytale uses QUIC protocol over UDP. TCP forwarding is NOT required.

    7(Optional) Create Systemd Service

    Create a systemd service for automatic startup and management.

    /etc/systemd/system/hytale.service
    [Unit]
Description=Hytale Dedicated Server
After=network.target

[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server/Server
ExecStart=/usr/bin/java -Xms4G -Xmx8G -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets ../Assets.zip
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
    # Enable and start the service
sudo systemctl daemon-reload
sudo systemctl enable hytale
sudo systemctl start hytale

# Check status
sudo systemctl status hytale

    Connecting to Your Server

    Once your server is running and authenticated, players can connect using:

    • Direct Connect: Use your public IP and port (e.g., 123.45.67.89:5520)
    • Find your IP: Run curl ifconfig.me