A container wrapping the official Hytale server downloader for automatic updates and easy container access.
  • Shell 68.2%
  • Dockerfile 31.8%
Find a file
Lukas Weber | @SakulFlee fcc6f73506
Some checks failed
Forgejo-Containers/Hytale/pipeline/head This commit looks good
Build and Publish Container / build-and-push (push) Has been cancelled
Forgejo-Containers/Hytale/pipeline/tag This commit looks good
Added option for downloading mods from an URL
2026-01-30 06:04:12 +01:00
.github/workflows Only push package if tagged 2026-01-27 04:30:58 +01:00
Containerfile Revert "Added NYO Mod Manager" 2026-01-30 05:35:47 +01:00
entrypoint.sh Added option for downloading mods from an URL 2026-01-30 06:04:12 +01:00
Jenkinsfile Removed dev publishing 2026-01-28 01:17:00 +01:00
README.md Fixed badges 2026-01-28 02:05:35 +00:00
renovate.json Add renovate.json 2026-01-26 04:00:24 +00:00

📦 Hytale Container Image

Origin: Forgejo Mirror: GitHub

A feature rich Container image for running Hytale servers!

Features

  • Authentication token caching
  • Automatic updating upon restart
  • [Planned] Mod downloading

Running

First, start the container:

# Or use docker!
podman run \
    -itd \
    --name hytale \
    -v hytale:/opt/hytale:U
    -p 5520:5520
    forgejo.sakul-flee.de/containers/hytale:latest

Next, the Hytale downloader needs to be authorized. Check the container logs and follow the instructions:

podman logs -f hytale

After authorization, the latest server files will be downloaded and prepared. This may take a few minutes based on your internet connection.

Eventually, the Hytale server should start. Once again, it has to be authorized first. Exit the logs and attach to the container instead:

podman attach -it hytale

You should have full access to the Hytale server console now. In the console enter and follow the instructions:

auth login device

Your server should be running and authenticated now. However, this is only a temporary authentication! To make this permanent enter:

auth persistence Encrypted

Now, your server should be authenticated even after restarting the container.

Warning

This container automatically checks for updates upon (re-)starting! The server will be updated assuming there is a new version and your credentials are still valid. Otherwise, you will be prompted to re-authenticate.

None of your save game, mods, configs, etc. should be affected by this!
Only the server files will be overwritten!
However, mods might struggle after an update.

Volumes

Path in container Description
/opt/hytale Location of the whole Hytale server. This includes saves ("Universe"), mods, configs and server files.

Ports

Port Protocol Description
5520 UDP Hytale Game Port

License

This project is licensed under Apache License 2.0.