HyOS - Hytale Server Management

Deploy HyOS using Docker Compose on any Linux, macOS, or Windows system with Docker.

The simplest way to deploy HyOS is with Docker Compose. This works on any system with Docker installed.

Prerequisites

Docker Engine 24+ with Compose v2
8 GB RAM minimum
x86_64 architecture

Quick Deploy

Create a docker-compose.yml file:

services:
  hytale-server:
    image: ghcr.io/editmysave/hyos/server:latest
    container_name: hytale-server
    ports:
      - "30520:30520/udp"   # Game server
      - "30080:30080/tcp"   # API plugin
    volumes:
      - ./data:/data
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - JAVA_XMS=2G
      - JAVA_XMX=4G
    restart: unless-stopped

  hyos-manager:
    image: ghcr.io/editmysave/hyos/manager:latest
    container_name: hyos-manager
    ports:
      - "3000:3000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./data:/data:ro
    environment:
      - HYTALE_CONTAINER_NAME=hytale-server
      - API_BASE_URL=http://hytale-server:30080
    restart: unless-stopped
    depends_on:
      - hytale-server

Then start it:

docker compose up -d

First Run

Check logs for the authentication prompt:

docker logs -f hytale-server

Complete the OAuth device flow when prompted
The server will download game files and start automatically
Access the manager UI at http://localhost:3000

Updating

Pull the latest images and recreate:

docker compose pull
docker compose up -d

Configuration

See the Configuration Reference for all available environment variables.

Next Steps

Configuration — Tune JVM, server settings, and auto-updates
Mods — Install and manage mods
Dashboard — Use the web UI
TrueNAS Deployment — Deploy on TrueNAS SCALE

Docker Compose Deployment