Minecraft

Deploy Minecraft Java Edition servers on Kubernetes using the itzg/minecraft-server container image. Supports multiple server types, cross-play, modding, monitoring, and scheduled backups.

Key Features

Multiple Server Types — Vanilla, Paper, Spigot, Forge, Fabric, Quilt
GeyserMC Cross-Play — Allow Bedrock clients (mobile, console) to join Java servers
Authentication — Online/offline mode, whitelist, operators
RCON — Remote console with auto-generated password
Scheduled Backups — CronJob-based backup to S3-compatible storage
Prometheus Monitoring — mc-monitor sidecar with ServiceMonitor
Mod/Plugin Support — Modrinth, CurseForge, Spiget, direct URLs
Optimized JVM — Aikar’s GC flags for production workloads

Installation

HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install minecraft helmforge/minecraft --set server.eula=true

OCI registry:

helm install minecraft oci://ghcr.io/helmforgedev/helm/minecraft --set server.eula=true

Basic Example

# values.yaml
server:
  eula: true
  type: PAPER
  motd: 'My Minecraft Server'
  maxPlayers: 20

jvm:
  memory: 2G
  useAikarFlags: true

auth:
  onlineMode: true
  whitelist: 'player1,player2'
  ops: 'player1'

persistence:
  enabled: true
  size: 20Gi

Cross-Play Example

server:
  eula: true
  type: PAPER

geyser:
  enabled: true
  port: 19132

mods:
  modrinthProjects: 'geyser,floodgate'

Key Values

Key	Default	Description
`server.eula`	`true`	Accept the Minecraft EULA (required)
`server.type`	`VANILLA`	Server type (VANILLA, PAPER, FORGE, FABRIC, etc.)
`server.version`	`LATEST`	Minecraft version
`server.maxPlayers`	`20`	Maximum concurrent players
`jvm.memory`	`1G`	JVM heap allocation
`jvm.useAikarFlags`	`false`	Aikar’s optimized GC flags
`auth.onlineMode`	`true`	Mojang online authentication
`auth.whitelist`	`""`	Whitelisted players
`geyser.enabled`	`false`	Enable GeyserMC cross-play
`rcon.enabled`	`true`	Enable RCON remote console
`metrics.enabled`	`false`	Enable Prometheus metrics
`backup.enabled`	`false`	Enable S3 backups
`persistence.enabled`	`true`	Enable persistent storage
`persistence.size`	`10Gi`	PVC size

More Information

See the source code and full values reference on GitHub.