https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm
Docker container providing a Valheim dedicated server. Helm chart for running a Valheim dedicated server on Kubernetes.
https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm
docker docker-compose docker-image helm-chart kubernetes valheim
Last synced: 5 months ago
JSON representation
Docker container providing a Valheim dedicated server. Helm chart for running a Valheim dedicated server on Kubernetes.
- Host: GitHub
- URL: https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm
- Owner: max-pfeiffer
- License: mit
- Created: 2025-05-29T06:35:29.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-31T15:02:47.000Z (6 months ago)
- Last Synced: 2026-01-03T14:20:59.296Z (6 months ago)
- Topics: docker, docker-compose, docker-image, helm-chart, kubernetes, valheim
- Language: Python
- Homepage: https://hub.docker.com/r/pfeiffermax/valheim-dedicated-server
- Size: 349 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://python-poetry.org/)
[](https://github.com/astral-sh/ruff)
[](https://codecov.io/gh/max-pfeiffer/valheim-dedicated-server-docker-helm)
[](https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm/actions/workflows/code-quality.yaml)
[](https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm/actions/workflows/publish.yaml)
[](https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm/actions/workflows/helm-release.yaml)
# Valheim Dedicated Server - Docker Image and Helm Chart
This Docker image provides a [Valheim](https://www.valheimgame.com/) dedicated game server.
You will find here also a [Helm Chart](https://helm.sh/) for running a Valheim dedicated server on [Kubernetes container orchestration system](https://kubernetes.io/).
My automation checks the [Valheim public branch](https://steamdb.info/app/896660/depots/?branch=public) every
night. If a new release was published by [Iron Gate Studios](https://irongate.se/), a new Docker image will be built
with this new version. Just use the `latest` tag and you will always have an up-to-date Docker image. No need to
manually run any server updates and mess around with your Docker image. It's that simple. :smiley:
Have a look at the [docker compose example](examples/docker-compose/compose.yaml) and
[its documentation](examples/docker-compose#automated-server-updates).
There you can see how a server update can be automated with a simple script.
Kudus to:
* [@jonakoudijs](https://github.com/jonakoudijs) for providing the [Steamcmd Docker image](https://github.com/steamcmd/docker) which is used here
**Docker Hub:** https://hub.docker.com/r/pfeiffermax/valheim-dedicated-server
**GitHub Repository:** https://github.com/max-pfeiffer/valheim-dedicated-server-docker-helm
## Usage
### Configuration
You can append all [Valheim console commands](https://www.valheimgame.com/support/a-guide-to-dedicated-servers/) as commands
when running `valheim_server.x86_64` binary. Use the regular syntax like `-name ValheimServer` or `-public 1`.
As the Valheim server is running in the Docker container as a stateless application, you want to have all stateful server
data (config, saves, etc.) stored in a [Docker volume](https://docs.docker.com/storage/volumes/)
which is persisted **outside** the container. This can be configured with `-savedir`: you can specify the
directory where this data is stored. You need to make sure that this directory is mounted on
a [Docker Volume](https://docs.docker.com/storage/volumes/).
This is especially important because you need to update the Valheim server image every month when
[Iron Gate Studios](https://irongate.se/) releases a new software update. When you use a
[Docker volume](https://docs.docker.com/storage/volumes/) to store the `-savedir`, all the data is still intact.
### Docker Run
For testing purposes, you can fire up a Docker container like this:
```shell
docker run -it --publish 2456:2456/udp pfeiffermax/valheim-dedicated-server:latest -name ValheimServer -world NewWorld -password supersecret -public 0
```
### Docker Compose
Please have a look at the [docker compose example](examples/docker-compose/README.md).
## Helm chart
If you would like to run the Valheim server in your [Kubernetes](https://kubernetes.io/) cluster, I provide a
[Helm chart](https://helm.sh/) you could use: [https://max-pfeiffer.github.io/valheim-dedicated-server-docker-helm](https://max-pfeiffer.github.io/valheim-dedicated-server-docker-helm)
There is also [documentation available](charts/valheim/README.md) for that Helm chart.
If you want to run your Valheim server on bare metal Kubernetes, check out
[my blog article](https://max-pfeiffer.github.io/blog/hosting-game-servers-on-bare-metal-kubernetes-with-kube-vip.html)
on how to do that using [kube-vip](https://kube-vip.io/).
## Additional Information Sources
* [SteamDB](https://steamdb.info/app/896660/info/)
* [Official Valheim dedicated server guide](https://www.valheimgame.com/support/a-guide-to-dedicated-servers/)
* [Valheim dedictated server Fandom Wiki](https://valheim.fandom.com/wiki/Dedicated_servers)
## Other Game Server Projects
* [Rust dedicated server](https://github.com/max-pfeiffer/rust-game-server-docker)