mini-server-manager/managed-valheim
1
1 Fork 0
Code Issues 5 Pull Requests Actions Packages Projects 1 Releases 1 Wiki Activity
Page: Home
Pages
Backup & Restore FAQ Home Installation Modding Guide Quick Start Troubleshooting Version History
Clone
4
Home
the_minisip edited this page 2026-10-16 13:15:58 -03:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Managed Valheim Server

Managed Valheim is a fully automated, self-updating, BepInEx‑patched Valheim dedicated server designed for TrueNAS SCALE and other container platforms. It provides a clean SteamCMD installation, reliable mod integration, and optional world backup automation.

What This Project Provides

  • Automatic SteamCMD installation & updates
    The server installs and updates itself every time the container starts. SteamCMD handles validation and patching using anonymous login.
  • Managed BepInEx integration
    The container downloads, validates, and installs the official BepInExPack Valheim from Thunderstore, then applies required patches and generates a managed startup wrapper.
  • Clean + Modded directory separation
    SteamCMD installs into /opt/valheim_base (clean), while the server runs from /opt/valheim (modded). This prevents SteamCMD rollback errors and ensures reliable updates.
  • Automated world backups
    The server can automatically back up world files at a configurable interval, storing timestamped ZIP archives in /backups. Old backups are pruned based on a retention window.
  • TrueNAS SCALE ready
    Exposes Valheim ports (2456–2458 UDP), supports persistent volumes, and integrates cleanly with SCALE’s app configuration system.

Key Environment Variables

Variable Default Description
SERVER_NAME Valheim Server Display name of the server
WORLD_NAME Dedicated World save name
SERVER_PASSWORD changeme Password required to join
PUBLIC 1 Public listing toggle
BACKUP_INTERVAL 21600 Backup interval (seconds)
BACKUP_RETENTION_DAYS 7 Days to retain backups

How It Works

  1. Container starts and runs entrypoint.sh.
  2. SteamCMD installs or updates Valheim in /opt/valheim_base.
  3. Updated binaries are copied into /opt/valheim.
  4. BepInEx is downloaded, validated, extracted, and patched.
  5. The managed wrapper launches the server with correct parameters.
  6. A background loop performs world backups and pruning.

Directory Layout

  • /opt/steamcmd — SteamCMD installation
  • /opt/valheim_base — Clean Valheim install
  • /opt/valheim — Modded runtime directory
  • /backups — Managed backup output
  • /config — TrueNAS SCALE config volume

Notes

  • Shader warnings and libParty.so errors are normal for headless servers and do not affect gameplay.
  • All logs stream to container stdout and are visible in TrueNAS SCALE.
  • BepInEx logs appear under /opt/valheim/BepInEx/.

For detailed configuration, troubleshooting, and modding instructions, see the other pages in this wiki.