Hytale Docker Server

Production-ready Docker container for Hytale dedicated servers

Automated authentication • Auto-updates • CurseForge mods • Secure by default

What is Hytale Docker?

Hytale Docker is a production-ready containerized solution for running Hytale dedicated servers. It handles authentication, updates, and mod management so you can focus on playing.

Documentation

🚀 Quick Start

Get your server running in minutes

⚙️ Configuration

Environment variables and settings

💻 CLI Reference

Unified command-line interface

🧩 CurseForge Mods

Auto-sync mods from CurseForge

🧩 Modtale Mods

Auto-sync mods from Modtale

🔐 Authentication

OAuth2 device flow details

🔧 Troubleshooting

Common issues and solutions

Key Features

Feature	Description
One-command startup	Just `docker compose up`, authenticate once, play forever
OAuth2 Authentication	Device code flow with 30-day persistent tokens
Auto-updates	Optional automatic server updates on restart
CurseForge & Modtale Mods	Auto-sync mods with `CF_MODS` and `MT_MODS` environment variables
Unified CLI	Single `hytale` command for auth, updates, mods, and server commands
Secure by default	Non-root user, dropped capabilities, hardened container
Fast boot	AOT cache support for quicker startup
Persistent data	Worlds, tokens, and mods survive restarts

Quick Example

services:
  hytale:
    image: rxmarin/hytale-docker:latest
    container_name: hytale-server
    restart: unless-stopped
    stdin_open: true
    tty: true
    ports:
      - "5520:5520/udp"
    environment:
      JAVA_OPTS: "-Xms4G -Xmx8G"
      AUTO_UPDATE: "true"
    volumes:
      - hytale-data:/server

volumes:
  hytale-data:

docker compose up -d
docker compose logs -f  # Watch for auth prompt

Introduction