Official Docker images for EverHytale projects.
| Image | Description | Registry |
|---|---|---|
| hytale-server | Optimized Hytale dedicated server | ghcr.io/ivanjx/hytale-server |
All images now use only the Hytale downloader version and latest:
| Tag | Description | Example |
|---|---|---|
latest |
Latest available built image | ghcr.io/ivanjx/hytale-server:latest |
HYTALE_VERSION |
Hytale version from downloader | ghcr.io/ivanjx/hytale-server:0.5.1 |
The CI/CD pipeline automatically checks for new Hytale versions every 12 hours. When a new version is detected, a new Docker image is built and pushed with the appropriate tags.
# Latest stable release
docker pull ghcr.io/ivanjx/hytale-server:latest
# Specific Hytale version (latest image)
docker pull ghcr.io/ivanjx/hytale-server:0.5.1
# Run the server
docker run -d \
--name hytale-server \
-p 5520:5520/udp \
-v hytale-data:/server \
ghcr.io/ivanjx/hytale-server:latestSee hytale-server documentation for detailed usage.
dockers/
├── .github/
│ └── workflows/
│ └── hytale-server.yml # CI/CD for hytale-server
├── dockers/
│ └── hytale-server/ # Hytale server Docker image
│ ├── Dockerfile
│ ├── docker-compose.yml
│ ├── docker-compose.build.yml
│ ├── entrypoint.sh
│ ├── scripts/
│ │ ├── download-game.sh
│ │ ├── hytale-auth.sh
│ │ └── hytale-refresh.sh
│ └── README.md
├── LICENSE
└── README.md
Each image can be built locally. Game files must be downloaded first using the provided script.
cd dockers/hytale-server
# 1. Create credentials file (see hytale-auth.sh for OAuth flow)
echo '{"access_token":"...", "refresh_token":"..."}' > .hytale-downloader-credentials.json
# 2. Download game files
./scripts/download-game.sh
# 3. Build the image
HYTALE_VERSION=$(cat game-files/.version) docker compose -f docker-compose.build.yml build
# 4. Run the server
docker compose -f docker-compose.build.yml up -dContributions are welcome! Please read the Contributing Guidelines before submitting a PR.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by the EverHytale community