Valheim

Docker

If you are looking for a guide on how to get started click here

Mod Support! It is supported to launch the server with BepInEx but!!!!! as a disclaimer! You take responsibility for debugging why your server won't start. Modding is not supported by the Valheim developers officially yet; Which means you WILL run into errors. This repo has been tested with running ValheimPlus as a test mod and does not have any issues. See Getting started with mods

Download Locations

DockerHub

GitHub Container Registry

Environment Variables

See further on down for advanced environment variables.

Variable	Default	Required	Description
PORT	2456	TRUE	Sets the port your server will listen on. Take note it will also listen on +2 (ex: 2456, 2457, 2458)
NAME	Valheim Docker	TRUE	The name of your server! Make it fun and unique!
WORLD	Dedicated	TRUE	This is used to generate the name of your world.
PUBLIC	1	FALSE	Sets whether or not your server is public on the server list.
PASSWORD	<please set me>	TRUE	Set this to something unique!
TYPE	Vanilla	FALSE	This can be set to ValheimPlus, BepInEx, BepInExFull or Vanilla
MODS	<nothing>	FALSE	This is an array of mods separated by comma and a new line. Click Here for Examples Supported files are zip, dll, and cfg.

| WEBHOOK_URL | <nothing> | FALSE | Supply this to get information regarding your server's status in a webhook or Discord notification! Click here to learn how to get a webhook url for Discord | | UPDATE_ON_STARTUP | 1 | FALSE | Tries to update the server the container is started. |

Container Env Variables

Variable	Default	Required	Description
TZ	America/Los_Angeles	FALSE	Sets what timezone your container is running on. This is used for timestamps and cron jobs. Click Here for which timezones are valid.
PUID	1000	FALSE	Sets the User Id of the steam user.
PGID	1000	FALSE	Sets the Group Id of the steam user.

Auto Update

Variable	Default	Required	Description
AUTO_UPDATE	0	FALSE	Set to 1 if you want your container to auto update! This means at the times indicated by AUTO_UPDATE_SCHEDULE it will check for server updates. If there is an update then the server will be shut down, updated, and brought back online if the server was running before.
AUTO_UPDATE_SCHEDULE	0 1 * * *	FALSE	This works in conjunction with AUTO_UPDATE and sets the schedule to which it will run an auto update. If you need help figuring out a cron schedule click here
AUTO_UPDATE_PAUSE_WITH_PLAYERS	0	FALSE	Does not process an update for the server if there are players online.

Auto update job, queries steam and compares it against your internal steam files for differential in version numbers.

Auto Backup

Variable	Default	Required	Description
AUTO_BACKUP	0	FALSE	Set to 1 to enable auto backups. Backups are stored under /home/steam/backups which means you will have to add a volume mount for this directory.
AUTO_BACKUP_SCHEDULE	*/15 * * * *	FALSE	Change to set how frequently you would like the server to backup. If you need help figuring out a cron schedule click here.
AUTO_BACKUP_REMOVE_OLD	1	FALSE	Set to 0 to keep all backups or manually manage them.
AUTO_BACKUP_DAYS_TO_LIVE	3	FALSE	This is the number of days you would like to keep backups for. While backups are compressed and generally small it is best to change this number as needed.
AUTO_BACKUP_ON_UPDATE	0	FALSE	Create a backup on right before updating and starting your server.
AUTO_BACKUP_ON_SHUTDOWN	0	FALSE	Create a backup on shutdown.
AUTO_BACKUP_PAUSE_WITH_NO_PLAYERS	0	FALSE	Will skip creating a backup if there are no players. PUBLIC must be set to 1 for this to work!

Auto backup job produces an output of a *.tar.gz file which should average around 30mb for a world that has an average of 4 players consistently building on. You should be aware that if you place the server folder in your saves folder your backups could become astronomical in size. This is a common problem that others have observed, to avoid this please follow the guide for how volume mounts should be made in the docker-compose.yml.

Http Server

Variable	Default	Required	Description
ADDRESS	Your Public IP	FALSE	This setting is used in conjunction with odin status and setting this will stop odin from trying to fetch your public IP
HTTP_PORT	anything above 1024	FALSE	Setting this will spin up a little http server that provides two endpoints for you to call.

• /metrics provides a prometheous style metrics output.
• /status provides a more traditional status page.

Note on ADDRESS this can be set to 127.0.0.1:<your query port> or <your public ip>:<your query port> but does not have to be set. If it is set, it will prevent odin from reaching out to aws ip service from asking for your public IP address. Keep in mind, your query port is +1 of what you set in the PORT env variable for your valheim server.

Docker Compose

Simple

This is a basic example of a docker compose, you can apply any of the variables above to the environment section below but be sure to follow each variables' description notes!

version: "3"
services:
  valheim:
    image: mbround18/valheim:latest
    ports:
      - 2456:2456/udp
      - 2457:2457/udp
      - 2458:2458/udp
    environment:
      PORT: 2456
      NAME: "Created With Valheim Docker"
      WORLD: "Dedicated"
      PASSWORD: "Banana Phone"
      TZ: "America/Chicago"
      PUBLIC: 1
    volumes:
      - ./valheim/saves:/home/steam/.config/unity3d/IronGate/Valheim
      - ./valheim/server:/home/steam/valheim

Everything but the kitchen sink

version: "3"
services:
  valheim:
    image: mbround18/valheim:latest
    ports:
      - 2456:2456/udp
      - 2457:2457/udp
      - 2458:2458/udp
    environment:
      PORT: 2456
      NAME: "Created With Valheim Docker"
      WORLD: "Dedicated"
      PASSWORD: "Strong! Password @ Here"
      TZ: "America/Chicago"
      PUBLIC: 1
      AUTO_UPDATE: 1
      AUTO_UPDATE_SCHEDULE: "0 1 * * *"
      AUTO_BACKUP: 1
      AUTO_BACKUP_SCHEDULE: "*/15 * * * *"
      AUTO_BACKUP_REMOVE_OLD: 1
      AUTO_BACKUP_DAYS_TO_LIVE: 3
      AUTO_BACKUP_ON_UPDATE: 1
      AUTO_BACKUP_ON_SHUTDOWN: 1
      WEBHOOK_URL: "https://discord.com/api/webhooks/IM_A_SNOWFLAKE/AND_I_AM_A_SECRET"
      UPDATE_ON_STARTUP: 0
    volumes:
      - ./valheim/saves:/home/steam/.config/unity3d/IronGate/Valheim
      - ./valheim/server:/home/steam/valheim
      - ./valheim/backups:/home/steam/backups

Odin

This repo has a CLI tool called Odin in it! It is used for managing the server inside the container. If you are looking for instructions for it click here: Odin

Click here to see advanced environment variables for Odin

BepInEx Support

This repo automatically launches with the proper environment variables for BepInEx. However, you have to install it manually in the container due to the fact that the modding community around Valheim is still in its infancy.

Click Here to view documentation on BepInEx Support

Webhook Support

This repo can automatically send notifications to discord via the WEBHOOK_URL variable. Only use the documentation link below if you want advanced settings!

Click Here to view documentation on Webhook Support

How to Transfer Files

This is a tutorial of a recommended path to transfering files. This can be done to transfer world files between hosts, transfer BepInEx configs, or even to transfer backups.

Click Here to view the tutorial of how to transfer files.

Sponsors

Release Notifications

If you would like to have release notifications tied into your Discord server, click here:

Note: The discord is PURELY for release notifications and any + all permissions involving sending chat messages has been disabled. Any support for this repository must take place on the Discussions.

Versions

• latest (Stable):
  • #100 Added backup feature to run based on cronjob.
  • #148 Added Mod support
  • #158 Added webhook configuration and documentation updates
  • #236 Now publish to github registry as well
  • #276 Advanced mod support with auto installer
• 1.2.0 (Stable):
  • Readme update to include the versions section and environment variables section.
  • #18 Changed to root as the default user to allow updated steams User+Group IDs.
  • #18 Fixed issue with the timezone not persisting.
  • To exec into the container you now have to include the -u|--user argument to access steam directly. Example docker-compose exec --user steam valheim bash
  • There is now a dry-run command argument on odin to preview what the command would do.
  • You can run with -d|--debug to get verbose logging of what odin is doing.
  • #11 Added check for length of password and fail on odin install or odin stop failures.
  • #24 Added public variable to dockerfile and odin
  • #35 Fix for the server to now utilizing SIGINT YOU WILL HAVE TO MANUALLY STOP YOUR SERVER; use pidof valheim_server.x86_64 to get the pid and then kill -2 $pid but replace pid with the pid from pidof
  • #53 Formatted scripts to be more useful and added timezone scheduling.
  • #77 Fix auto update not acknowledging variables and added odin to system bin.
  • #89 Daemonized the server process by using rust specific bindings rather than dropping down to shell.
• 1.1.1 (Stable):
  • Includes PR #10 to fix the double world argument.
• 1.1.0 (Stable):
  • Includes a fix for #3 and #8.
  • Improves the script interface and separation of concerns, files now have a respective code file that supports interactions for cleaner development experience.
  • Docker image is cleaned up to provide a better usage experience. There is now an AUTO_UPDATE feature.
  • Has a bug where the script has two entries for the world argument.
• 1.0.0 (Stable):
  • It works! It will start your server and stop when you shut down.
  • This supports passing in environment variables or arguments to odin
  • Has a bug in which it does not read passed in variables appropriately to Odin. Env variables are not impacted see #3.