Hytale Launcher
Hytale Launcher
First launcher

Hytale Server Deployment Guide

This guide contains step-by-step instructions for installing and running Hytale server software on Windows and Linux operating systems.

11. Download Required Components

First, make sure you have downloaded the latest versions of the files from our website:

Download HytaleServer.jarDownload Assets.zip

22. Installing Java Environment (JDK 25)

Hytale server version 2026 requires Java Development Kit (JDK) 25. We recommend using the Temurin build from the Adoptium project.

Instructions for Windows:

  1. Go to the Adoptium Temurin 25 download page.
  2. Select and download the installer with .msi extension (Windows x64).
  3. Run the file. In the component selection window, make sure to set the following options to "Will be installed on local hard drive":
    • Add to PATH (Add to PATH environment variable).
    • Set JAVA_HOME variable (Set JAVA_HOME variable).
  4. Complete the installation and restart your computer.

Instructions for Linux (Ubuntu/Debian):

Execute the following commands in terminal:

# Update package lists and install dependencies
sudo apt update && sudo apt install -y wget apt-transport-https gnupg

# Add GPG key and official Adoptium repository
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

# Install JDK 25
sudo apt update && sudo apt install -y temurin-25-jdk

33. Server Setup and Run

Place HytaleServer.jar and Assets.zip in the same folder (e.g., C:\HytaleServer or /home/user/hytale).

Run on Windows (.bat file)

Create a start.bat file in the folder using a text editor and paste the following:

@echo off
:: -Xmx4G allocates 4 GB of RAM for the server
java -Xmx4G -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:25565 --auth-mode offline
pause

Change port: Replace 25565 with any available port.

Run: Run: Simply double-click the start.bat file.

Run on Linux (via Screen)

To run the server in the background, use the screen utility:

1. Install the utility: sudo apt install screen

2. Start the server in a new session:

screen -S hytale java -Xmx4G -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:25565 --auth-mode offline

Session management:

  • Detach: Press Ctrl + A, then D. The server will continue running.
  • Reattach: Enter the command screen -r hytale.

44. Network Access Configuration (Ports)

For players to connect to your server, you need to allow traffic through the selected port (default 25565) in the firewall.

Configuration on Windows:

  1. Open "Windows Defender Firewall with Advanced Security".
  2. Create an "Inbound Rule":
    • Rule type: For port.
    • Protocol: TCP. Port: 25565.
    • Action: Allow the connection.

Important: Repeat the procedure for UDP protocol, as Hytale may use both types of traffic.

Configuration on Linux (UFW):

sudo ufw allow 25565/tcp
sudo ufw allow 25565/udp
sudo ufw reload

55. Command Line Parameters (Reference)

ParameterDescription
-Xmx4GRAM allocation (in this case 4 GB).
--assets Assets.zipPath to the resource archive (required parameter).
--bind 0.0.0.0:PORTIP address and port that the server will listen on.
--auth-mode offlineDisables license verification (mode for local networks/testing).

Note: If you're running the server on a home PC, you may also need to set up "Port Forwarding" in your router settings.