🚀 Hytale Server Container 📦 49.4MB (Alpine/Liberica) • Secure non-root execution • QUIC/UDP support • Built-in Production & Debug diagnostics • Pterodactyl supported https://deinfreu.github.io/hytale-server-container/?utm_source=github&utm_medium=social
Find a file
2026-02-07 05:43:33 +01:00
.github feat: add GitHub Actions workflows for main and staging branches 2026-01-29 21:25:01 +01:00
assets Add metadata and robots.txt for improved SEO and bot management 2026-01-15 07:05:55 +01:00
docs fix: CLS from 1 to a zero because of render blocking issues 2026-02-07 05:43:33 +01:00
examples feat: update URLs and enhance documentation for improved clarity and accessibility 2026-01-28 01:29:28 +01:00
scripts fix: remove unnecessary condition for server token check in hytale_auth.sh 2026-01-29 21:44:37 +01:00
.dockerignore style: add /examples directory to .dockerignore 2026-01-27 18:06:07 +01:00
.gitattributes Squashed commit of the following: 2026-01-15 03:08:31 +01:00
.gitignore fix: add cache options for AOT and logging in entrypoint and hytale_options scripts 2026-01-29 14:27:03 +01:00
docker-compose.yml style: update .gitignore to exclude docker-compose files and add new docker-compose examples for TrueNAS Scale 2026-01-27 18:06:18 +01:00
Dockerfile.alpine fix: add coreutils to dependencies in Dockerfiles 2026-01-25 13:49:36 +01:00
Dockerfile.alpine-liberica fix: add coreutils to dependencies in Dockerfiles 2026-01-25 13:49:36 +01:00
Dockerfile.ubuntu fix: update Dockerfile to use JDK instead of JRE for builder and runtime stages 2026-01-29 14:25:35 +01:00
DOCKERHUB.md fix: correct URL in troubleshooting section of DOCKERHUB.md 2026-01-29 14:44:51 +01:00
entrypoint.sh refactor: reorganize entrypoint script 2026-01-29 16:47:07 +01:00
LICENSE Initial commit 2026-01-07 01:33:27 +01:00
README.md fix: update workflow to trigger on DOCKERHUB.md and add DOCKERHUB.md for Docker Hub 2026-01-29 14:42:02 +01:00
SECURITY.md style: update target branches and image tags from 'experimental' to 'latest' in configuration files and documentation 2026-01-27 15:52:19 +01:00

Docker Hytale Server Logo

GitHub stars GitHub last commit Discord Docker Pulls Docker Image Size (tag) GitHub license

Deploy a Hytale dedicated server with a community-focused Docker image by 10+ contributors. This project simplifies Hytale self-hosting with built-in security, networking and debugging tools. Join our active Discord for direct support and to connect with other server owners. Whether you're testing mods or running a persistent world, this container provides a consistent, production-ready environment in one command.

Support & Resources

  • Documentation: Detailed performance optimizations and security specifications are located in the Project Docs.
  • Troubleshooting: Check the support page and our Security Policy before reporting issues. You can also visit our Discord

Quick start

Install docker CLI on linux or the GUI on windows, macos and linux

You can run the container by running this in your CLI

docker run \
  --name hytale-server \
  -e SERVER_IP="0.0.0.0" \
  -e SERVER_PORT="5520" \
  -e PROD="FALSE" \
  -e DEBUG="FALSE" \
  -e TZ="Europe/Amsterdam" \
  -p 5520:5520/udp \
  -v "hytale-server:/home/container" \
  -v "/etc/machine-id:/etc/machine-id:ro" \
  --restart unless-stopped \
  deinfreu/hytale-server:latest

Alternatively, you can deploy using Docker Compose. Use the configuration below or explore the examples folder for more advanced templates.

services:
  hytale:
    image: deinfreu/hytale-server:latest
    container_name: hytale-server
    environment:
      SERVER_IP: "0.0.0.0"
      SERVER_PORT: "5520"
      PROD: "FALSE"
      DEBUG: "FALSE"
      TZ: "Europe/Amsterdam"
    restart: unless-stopped
    ports:
      - "5520:5520/udp"
    volumes:
      - ./data:/home/container
      - /etc/machine-id:/etc/machine-id:ro
    tty: true
    stdin_open: true