Skip to content

A simple, lightweight and secure Valheim Dedicated Server docker image with Kubernetes Helm chart support.

License

Notifications You must be signed in to change notification settings

adaliszk/valheim-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docker Pulls :latest image size server build monitoring build helm build license

Valheim Docker Server & Helm Chart

Clean, fast and standalone Docker & Kubernetes helm deployments.

While there are many other images out there, they tend to fall into the bad habit of using anti-patterns, like using Supervisor and Cron in a single image. The images included here aim to avoid these bad habits, while still offering a full feature-set for managing and monitoring your Valheim Server.

What features do the images have?

  • A fully working Valheim Server without the need of steam downloading anything from the internet.
  • Using a non-root user to mitigate potential vulnerabilities.
  • Gracefully stops the server; enables proper saving before shutdown to avoid world corruption.
  • Automatic Backup of the world files when the server saves them onto the disk.
  • Sanitized server output; say goodbye to the debug noise that is not important!
  • Health-checks to monitor the image's basic status
  • Companion image for monitoring: adaliszk/valheim-server-monitoring

Server:

adaliszk/valheim-server

Alternatives: ghcr.io/adaliszk/valheim-server, quay.io/adaliszk/valheim-server

  • vanilla latest - always the latest stable build of the server
  • 0.218.21, 0.218 - the server version released on 27/08/2024
  • bepinex-5.4.2202 bepinex-5.4.21 bepinex-5.4 bepinex - latest server using denkinson's BepInEx mod loader
  • plus-0.9.9.11 plus-0.9.9 plus-0.9 plus - the latest server using Valheim Plus mod
  • develop - build any actively testing branch

additionally, there are version prefixed tags from bepinex, and plus variants, so you could specify exactly which server you want to use, like: 0.204.04-bepinex-5.4.1601

docker run -p 2456-2457:2456-2457/udp adaliszk/valheim-server -name "My Server" -password="super!secret"

or

version: "3.8"
services:

  valheim:
    image: adaliszk/valheim-server
    environment:
      SERVER_NAME: "My custom message in the server list"
      SERVER_PASSWORD: "super!secret"
    ports:
      - 2456:2456/udp
      - 2457:2457/udp

More details about using this image

Kubernetes deployment:

helm repo add adaliszk https://charts.adaliszk.io
helm upgrade --install --create-namespace --wait my-valheim-server adaliszk/valheim-server

Monitoring companion:

adaliszk/valheim-server-monitoring

Alternatives: ghcr.io/adaliszk/valheim-server-monitoring, quay.io/adaliszk/valheim-server-monitoring

  • metrics - mtail metrics from the latest server version
  • prometheus - a pre-configured prometheus for docker environments
docker run --name my_server -d -p 2456-2457:2456-2457/udp adaliszk/valheim-server
docker run -d --volumes-from my_server:ro -d -p 3903:3903 adaliszk/valheim-server-monitoring:metrics

or

version: "3.8"
volumes:
  - logs: {}
services:

  valheim:
    image: adaliszk/valheim-server
    environment:
      SERVER_NAME: "My custom message in the server list"
      SERVER_PASSWORD: "super!secret"
    volumes:
      - logs:/logs
    ports:
      - 2456:2456/udp
      - 2457:2457/udp

  metrics:
    image: adaliszk/valheim-server-monitoring:metrics
    volumes:
      - logs:/logs:ro
    ports:
      - 3903:3903

Examples

Contributions

Feel free to open Tickets or Pull-Requests, however, keep in mind that the idea is to keep it simple, and separate the concerns into multiple small images that are ready without needing to download anything from the internet.

If you have questions, please use the Discussions tab or ping me on the Valheim Discord server: Kicsivazz#2537

About

A simple, lightweight and secure Valheim Dedicated Server docker image with Kubernetes Helm chart support.

Topics

Resources

License

Stars

Watchers

Forks

Packages