Self-host Valheim Server Docker

Container Image

docker pull ghcr.io/community-valheim-tools/valheim-server:1.4.1

What's Changed

• Make BepInEx/ValheimPlus updaters resilient to transient API failures (fixes #778) by @dreeko in #781
• Upgrade supervisor to 4.3.0 and drop setuptools by @JustinTArthur in #824
  • setuptools and pkg_resources are no longer in the image. Derived images or hooks that relied on them must install them.
• Filter the ZNet.GetPublicIP exception loop by default (#806) by @bpavlina in #831

New Contributors

• @dreeko made their first contribution in #781
• @bpavlina made their first contribution in #831

Full Changelog: v1.4.0...v1.4.1

Container Image

docker pull ghcr.io/community-valheim-tools/valheim-server:1.4.0

Highlights

Servers stuck on update state 0x6 now recover

SteamCMD needs the depot manifest of the installed build to update an existing
installation, and it cached those manifests inside the container, where they were
lost on every re-creation. Without the cache it asked Steam for the old manifest,
and anonymous logins are only granted request codes for a branch's current
manifest — so once Valheim had been updated, the request failed with Access Denied
and the update job ended in state 0x6. Process uid and file ownership were never
the cause.

• The manifest cache now lives at /opt/valheim/dl/depotcache, with
  $HOME/Steam/depotcache symlinked to it, so it survives container re-creation.
  An existing cache is migrated and only removed once the copy succeeds; otherwise
  it's left in place with a warning.
• If Steam does deny the installed manifest, appmanifest_896660.acf is moved aside
  as .denied and the update retried. SteamCMD then verifies the existing files and
  downloads only the changed chunks. Recovery also applies to an already-running
  server, and a failed download is never merged over the installation.

Fixes #758.

BepInEx patchers are synced from /config

write_bepinex_config() now syncs both plugins/ and patchers/, creating either
directory as needed since neither archive ships them any more. Patchers such as
HookGenPatcher previously needed a custom hook to install.

• BepInEx: plugins in /config/bepinex/plugins/, patchers in /config/bepinex/patchers/
• ValheimPlus: plugins in /config/valheimplus/plugins/, patchers in /config/valheimplus/patchers/

Fixes #392.

The /config sync now prunes removed plugins and patchers

The sync was additive-only: a plugin removed from /config stayed on the server
until the next merge. Each sync now records what it installed into
BepInEx/.synced_from_config, and the next sync removes exactly those entries once
they leave /config.

This is deliberately narrower than rsync --delete, which was tried and reverted
(#654, #658) because it removed ValheimPlus.dll from the plugins/ directory V+
ships it into (#657). Deleting everything absent from /config fails the same way
for files written there at runtime, such as HookGenPatcher's MMHOOK assemblies.

Upgrade note: nothing is deleted on your first start after upgrading. An install
with no .synced_from_config manifest prunes nothing and simply starts recording, so
plugins that came with the mod archive itself, and files a patcher generates at
runtime, are left alone. From the second sync onward, removing a plugin or patcher
from /config also removes it from the server directory.

What's Changed

• Fix updating older installations on new start, survive Steam refusing prior manifest (state 0x6) by @JustinTArthur in #812
• Sync BepInEx patchers and prune loadables removed from /config by @JustinTArthur in #811

Full Changelog: v1.3.0...v1.4.0

Container Image

docker pull ghcr.io/community-valheim-tools/valheim-server:1.3.0

What's Changed

• fix: create /var/run/valheim at runtime to prevent supervisord PID file boot loop by @Camfel in #785
• fix: detect CROSSPLAY=true in idle checks by @llit47 in #808
• Install valheim's crontab from bootstrap so cron works under no-new-privileges by @JustinTArthur in #809
• Fix datetime.utcnow() deprecation warning in valheim-status by @Buiko32 in #800
• fix: sync BepInEx plugins when pack no longer ships plugins/ dir (fixes #803) by @ahatius in #810
• remove references to obsolete config by @olsonpm in #804

New Contributors

• @Camfel made their first contribution in #785
• @llit47 made their first contribution in #808
• @Buiko32 made their first contribution in #800
• @ahatius made their first contribution in #810
• @olsonpm made their first contribution in #804

Full Changelog: v1.2.0...v1.3.0

Container Image

docker pull ghcr.io/community-valheim-tools/valheim-server:1.2.0

What's Changed

• Add upstream-dispatch to trigger shim by @lloesche in #775
• Revert to GHCR_PAT by @lloesche in #776
• Chunked world save dirs for Valheim 1.0+, based on 0.221.13 (PTB) by @JustinTArthur in #793

New Contributors

• @JustinTArthur made their first contribution in #793

Full Changelog: v1.1.0...v1.2.0

Container Image

docker pull ghcr.io/community-valheim-tools/valheim-server:1.1.0

This release was originally cut on the pre-merge community fork. The existing 1.1.0 image was built from fork commit b824ca1, which is not part of this repository's history; this tag points at its rebased equivalent (f476dfc), whose tree is identical.

Changes

• Update mod-injection environment variables for the newer libdoorstop distributed with Grantapher's ValheimPlus fork (default fork used by this image). This matches the scheme used for the regular BepInEx Pack's libdoorstop.
• Support for file-mounted values for some environment variables to support secret-injecting features of container runtimes. Original PR #748 from @bryanboettcher.
• Fix default file and directory permissions (derived from PERMISSIONS_UMASK). Original PR #760 from @Xeboc.

Carried over from 1.0.0

The 1.0.0 release was tagged on the pre-merge fork at commit 9220bdc, which is not in this repository, so there is no v1.0.0 tag here. The ghcr.io/community-valheim-tools/valheim-server:1.0.0 image still exists. Its changes are all included in this release:

• First release following fork from lloesche/valheim-server-docker. Minor docs/branding changes to distinguish.
• Updated base image to "trixie" series of Debian, slim variant. Contains a newer glibc, compatible with the newer builds of @AzumattDev's BepInEx pack for Valheim as distributed on @ghorsington's ThunderStore account and used by this image.
  • 32-bit glibc for SteamCMD still derived from antique Debian for the sake of old appliances.
• Switch to mod-injection environment variables for newer libdoorstop releases included in that BepInEx pack.