StatefulSet with persistent world data, NodePort service for game/query/ crossplay ports, and secret for the server password. Co-authored-by: Copilot <[email protected]>
1.7 KiB
1.7 KiB
valheim-gitops
Helm chart to run a Valheim dedicated server on Kubernetes,
using the community lloesche/valheim-server
image.
What's included
- Namespace (
valheimby default, toggle withnamespace.create) - StatefulSet running the game server with a persistent volume for world data
(
/configand/opt/valheim) so the world survives restarts/upgrades - Secret holding the server join password (
SERVER_PASS) - Service (
NodePortby default) exposing the game (2456/udp), query (2457/udp) and crossplay (2458/udp) ports - Headless Service for the StatefulSet
Configuration
See values.yaml for all options. Important ones:
| Key | Description | Default |
|---|---|---|
server.name |
Server name shown in the browser | Valtersheim |
server.worldName |
World save name | Midgard |
server.password |
Join password (override via -f secret-values.yaml, never commit real passwords) |
changeme-please-override |
service.type |
NodePort or LoadBalancer |
NodePort |
persistence.storageClassName |
StorageClass for world data, empty = cluster default | "" |
persistence.size |
Size of the world data volume | 10Gi |
Usage
helm upgrade --install valheim . -n valheim --create-namespace \
--set server.password=<your-password>
Deploying via ArgoCD
This repository is intended to be deployed as an ArgoCD Application using this
chart as the Helm source (see apps-in-apps repo for the bootstrap Application).
Never commit real passwords in
values.yaml. Use--set, a separate values file excluded from git, or a secrets manager (SealedSecrets/ExternalSecrets) for production.