fukuops/k8s/charts/valheim-server

valheim-server

A Helm chart for deploying a Valheim dedicated server on Kubernetes

Homepage: https://www.valheimgame.com/

Maintainers

Name	Email	Url
kriegalex	kriegalex@gmail.com

Source Code

• https://github.com/mbround18/valheim-docker
• https://github.com/kriegalex/k8s-charts/tree/main/charts/valheim-server

Overview

This Helm chart deploys a Valheim dedicated server based on the mbround18/valheim-docker project.

Features

• Configurable server settings
• Automatic updates and backups
• Discord webhook notifications
• Persistent storage for game saves, server files, and backups
• Resource management for Kubernetes

Prerequisites

• Kubernetes 1.29+
• Helm 3.16.0+
• PV provisioner support in the underlying infrastructure (for persistent storage)
• LoadBalancer support or an Ingress controller

TL;DR

helm repo add k8s-charts https://kriegalex.github.io/k8s-charts/
helm install my-valheim-server k8s-charts/valheim-server

Important Security Notice

The default values for this chart include a placeholder password. For production use:

1. Always specify a secure password
2. Consider using Kubernetes secrets for sensitive values
3. Restrict access to your server using appropriate network policies

Installation

Simple Install with Custom Password and Server Name

helm upgrade --install my-valheim-server \
  --set server.password="YourStrongPassword" \
  --set server.name="Your Awesome Valheim Server" \
  k8s-charts/valheim-server

Custom Configuration File

Create a YAML file with your custom values:

server:
  name: "My Custom Valheim Server"
  password: "SuperSecretPassword"
  world: "MyWorld"
  public: 1

persistence:
  saves:
    size: 5Gi
  backups:
    size: 20Gi

automation:
  autoBackup: 1  # disabled by default
  autoBackupSchedule: "*/30 * * * *"

resources:
  requests:
    memory: 4Gi
    cpu: 2000m
  limits:
    memory: 12Gi
    cpu: 4000m

Then install the chart:

helm install my-valheim-server -f my-values.yaml k8s-charts/valheim-server

Updating

helm upgrade my-valheim-server k8s-charts/valheim-server

Uninstallation

helm uninstall my-valheim-server

Note: This will not delete the Persistent Volume Claims. To delete them:

kubectl delete pvc -l app.kubernetes.io/instance=my-valheim-server

Values

Key	Type	Default	Description
affinity	object	{}	Affinity for pod assignment
automation.autoBackup	int	0	Enable automatic backups (1=enabled, 0=disabled)
automation.autoBackupDaysToLive	int	7	Number of days to keep backups
automation.autoBackupOnShutdown	int	0	Create backup on server shutdown (1=enabled, 0=disabled)
automation.autoBackupOnUpdate	int	1	Create backup before updates (1=enabled, 0=disabled)
automation.autoBackupRemoveOld	int	1	Remove old backups automatically (1=enabled, 0=disabled)
automation.autoBackupSchedule	string	"*/15 * * * *"	Cron schedule for automatic backups
automation.autoUpdate	int	1	Enable automatic updates (1=enabled, 0=disabled)
automation.autoUpdateSchedule	string	"0 1 * * *"	Cron schedule for automatic updates
automation.updateOnStartup	int	0	Update server when container starts (1=enabled, 0=disabled)
extraEnv	list	[]	Additional environment variables for the Valheim server
fullnameOverride	string	""	Provide a full name override for resources
image.pullPolicy	string	"IfNotPresent"	Image pull policy
image.repository	string	"mbround18/valheim"	Docker repository to use
image.tag	string	""	Docker tag to use - use "latest" for most current version
initContainers	object	{"args":[],"command":[],"enabled":false,"image":"busybox:latest"}	Init container configuration for server preparation
initContainers.args	list	[]	Init container arguments
initContainers.command	list	[]	Init container command
initContainers.enabled	bool	false	Enable init container
initContainers.image	string	"busybox:latest"	Init container image
livenessProbe.enabled	bool	false	Enable liveness probe
livenessProbe.failureThreshold	int	6 (allows up to 2 minutes for recovery)	Failure threshold
livenessProbe.initialDelaySeconds	int	60	Initial delay seconds
livenessProbe.periodSeconds	int	20	Period seconds
livenessProbe.timeoutSeconds	int	5	Timeout seconds
modding.bepInEx	int	0	Enable BepInEx for mods (1=enabled, 0=disabled)
modding.modPath	string	"/home/steam/valheim/BepInEx"	Path to mounted mod directory
modding.useConfigurationManager	bool	false	Enable mounting a ConfigurationManager config
nameOverride	string	""	Provide a name override for resources
nodeSelector	object	{}	Node selector for pod assignment
notifications.includePublicIp	int	0	Include the server's public IP in notifications (1=enabled, 0=disabled)
notifications.webhookUrl	string	""	Discord webhook URL for server notifications
persistence.backups.accessMode	string	"ReadWriteOnce"	Access mode for the PVC
persistence.backups.existingClaim	string	""	Existing claim to use (leave empty to create a new one)
persistence.backups.size	string	"10Gi"	Size of PVC for backups
persistence.enabled	bool	true	Enable persistent storage for server data
persistence.saves.accessMode	string	"ReadWriteOnce"	Access mode for the PVC
persistence.saves.existingClaim	string	""	Existing claim to use (leave empty to create a new one)
persistence.saves.size	string	"1Gi"	Size of PVC for game saves
persistence.server.accessMode	string	"ReadWriteOnce"	Access mode for the PVC
persistence.server.existingClaim	string	""	Existing claim to use (leave empty to create a new one)
persistence.server.size	string	"4Gi"	Size of PVC for server files
persistence.storageClass	string	use default storage class	Storage class to use (use null for default or "" for no storage class)
podSecurityContext.fsGroup	int	1000	File system group ID for volume mounts
readinessProbe.enabled	bool	true	Enable readiness probe
readinessProbe.failureThreshold	int	20 (allows up to 5 minutes for readiness)	Failure threshold
readinessProbe.initialDelaySeconds	int	60	Initial delay seconds
readinessProbe.periodSeconds	int	15	Period seconds
readinessProbe.timeoutSeconds	int	5	Timeout seconds
replicaCount	int	1	Number of replicas to deploy (should typically stay at 1)
resources	object	{}	Resource requests and limits
securityContext.runAsGroup	int	1000	Group ID to run the container processes
securityContext.runAsNonRoot	bool	true	Force the container to run as a non-root user
securityContext.runAsUser	int	111	User ID to run the container processes. Should default to the steam user ID.
server.name	string	"Valheim Server with Helm"	Server name as displayed in-game
server.password	string	you MUST change this value	Server access password (minimum 5 characters)
server.port	int	2456	UDP port for game server (will use PORT, PORT+1, and PORT+2)
server.public	int	0	Set to 1 to make server visible publicly, 0 for private
server.timezone	string	"UTC"	Timezone for the server
server.world	string	"Dedicated"	World name used for save files
service.annotations	object	{}	Annotations for the service
service.loadBalancerIP	string	""	Set specific load balancer IP (depends on cloud provider support)
service.loadBalancerSourceRanges	list	[]	External source IP ranges allowed to access the server
service.type	string	"LoadBalancer"	Service type
startupProbe.enabled	bool	true	Enable startup probe
startupProbe.failureThreshold	int	30 (allows up to 5 minutes for initial startup)	Failure threshold
startupProbe.initialDelaySeconds	int	30	Initial delay seconds
startupProbe.periodSeconds	int	10	Period seconds
startupProbe.timeoutSeconds	int	5	Timeout seconds
tolerations	list	[]	Tolerations for pod assignment

---

Autogenerated from chart metadata using helm-docs v1.14.2