Helm chart for Hytale
Find a file
Lukas Weber | @SakulFlee 18b955aa94
All checks were successful
Forgejo-HelmCharts/Hytale/pipeline/head This commit looks good
Forgejo-HelmCharts/Hytale/pipeline/tag This commit looks good
Version bump
2026-02-05 18:09:56 +01:00
.github/workflows Removed latest version push 2026-01-27 04:35:00 +01:00
templates Added deployment strategy 2026-02-05 18:09:51 +01:00
Chart.yaml Version bump 2026-02-05 18:09:56 +01:00
Jenkinsfile Trying with pipe 2026-01-27 04:02:18 +01:00
README.md Fixed badges 2026-01-28 02:07:18 +00:00
renovate.json Add renovate.json 2026-01-27 02:00:21 +00:00
values.yaml Changed to deployment 2026-02-03 04:29:31 +01:00

📦 Hytale Helm Chart

Origin: Forgejo Mirror: GitHub

Based on: HytaleContainer

A feature rich Helm Chart for running Hytale servers!

Features

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

Running

Install the Helm Chart:

helm install hytale oci://ghcr.io/sakulflee/charts/hytale

Then following instructions in Helm!
Most setups you won't need to change the values.

Values

General

Key Type Default Description
name string "hytale" Name of container
labels object {}

Persistence

Key Type Default Description
persistence.size string "10Gi"
persistence.storageClass string ""

Resources

Key Type Default Description
resources.limits.cpu string "4000m"
resources.limits.memory string "8Gi"
resources.requests.cpu string "2000m"
resources.requests.memory string "4Gi"

Note

Increasing the memory here doesn't automatically give the Hytale server more! Check JVM Arguments (-Xmx) for further adjustments.

Service

Key Type Default Description
service.port int 5520
service.type string "LoadBalancer"
service.udpPort int 520

Credentials

Key Type Default Description
credentials.credentialsKey string "credentials.json" Key inside secret
credentials.secretName string "hytale-credentials" Name of secret (can be empty; see below!)

Note

This is optional, you can set the secretName to an empty string and use the interactive authentication instead.

JVM Arguments

Key Type Default Description
jvm.additionalOptions[0] string "-server"
jvm.additionalOptions[1] string "-XX:+UseG1GC"
jvm.additionalOptions[2] string "-XX:+UseStringDeduplication"
jvm.additionalOptions[3] string "-Xmx4G" Max Java memory usage, adjust with requests & limits!
jvm.additionalOptions[4] string "-Xms512M"
jvm.additionalOptions[5] string "-server"

Note

This is a map that can be overwritten.

Image

Key Type Default Description
image.pullPolicy string "IfNotPresent"
image.repository string "ghcr.io/sakulflee/hytale"
image.tag string "latest"

Probes

Key Type Default Description
probes.liveness.initialDelaySeconds int 30
probes.liveness.periodSeconds int 30
probes.startup.failureThreshold int 100
probes.startup.file string "/tmp/.ready"
probes.startup.periodSeconds int 30

Security

Key Type Default Description
securityContext.fsGroup int 1000
securityContext.runAsGroup int 1000
securityContext.runAsNonRoot bool true
securityContext.runAsUser int 1000

License

This project is licensed under Apache License 2.0.