zneh/hytale-hybrid repository overview

⁠Hytale Hybrid Server Appliance

A production-grade, multi-architecture Docker image for the Hytale Dedicated Server. Optimized for high-performance x86_64 workstations and cost-effective ARM64 nodes (such as Oracle Cloud Ampere A1).

⁠Why this image?

• Hybrid Engine: The official Hytale CLI downloader is currently x86_64 only. This image uses Box64 to emulate the downloader on ARM64 while keeping the Java 25 server process native for zero performance loss.
• Automated Lifecycle: Handles downloader fetching, license verification, game synchronization (~3.3GB), and server booting in one flow.
• Identity Persistence: Maps /etc/machine-id to prevent session tokens from invalidating between container restarts.
• AOT Optimized: Includes Ahead-Of-Time (AOT) caching to minimize JIT overhead during world generation.

⁠Quick Start

docker run -it --rm \
  -p 5520:5520/udp \
  -v /etc/machine-id:/etc/machine-id:ro \
  -v $(pwd)/hytale_data:/home/container \
  -e SERVER_MEMORY=4096 \
  zneh/hytale-hybrid:latest

⁠Double Authentication Requirements

Hytale requires two distinct OAuth2 steps to go live:

1. Downloader Auth: You must have a valid Hytale license to download the game assets.
2. Server Auth: After the first boot, the console will provide a code. Visit https://accounts.hytale.com/device to register your instance.

⁠Configuration

• Port: Hytale uses 5520 UDP (QUIC). Ensure this is open in your VCN/Firewall.
• Java: Strictly requires OpenJDK 25.0.1+.
• Storage: Ensure at least 10GB of space is available for the initial sync.