From d01c1c9ee7890ec3f8e28697289579f2c689dd09 Mon Sep 17 00:00:00 2001 From: the_minisip Date: Fri, 16 Oct 2026 13:27:18 -0300 Subject: [PATCH] Add FAQ --- FAQ.md | 210 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 210 insertions(+) create mode 100644 FAQ.md diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 0000000..4b330cb --- /dev/null +++ b/FAQ.md @@ -0,0 +1,210 @@ +

Frequently Asked Questions (FAQ)

+ +

+ This page answers common questions about installing, running, updating, + modding, and backing up the Managed Valheim server. It is + designed to help new users and administrators quickly resolve typical issues. +

+ +
+ +

General Questions

+ +

What is Managed Valheim?

+

+ Managed Valheim is a fully automated, self-updating Valheim dedicated server + container with built-in BepInEx support, modding compatibility, and automated + world backups. It is designed for TrueNAS SCALE and other OCI platforms. +

+ +

Does the server update automatically?

+

+ Yes. Every time the container starts, SteamCMD installs or updates Valheim in + /opt/valheim_base, then copies updated files into the modded + runtime directory /opt/valheim. +

+ +

Does the server support mods?

+

+ Yes. BepInEx is installed automatically, and mods can be placed in: +

+ +
/opt/valheim/BepInEx/plugins
+ +
+ +

Installation & Configuration

+ +

Which volumes are required?

+ + +

Which ports need to be exposed?

+

+ Valheim requires three UDP ports: +

+ +
2456/udp
+2457/udp
+2458/udp
+
+ +

Which environment variables are required?

+

+ At minimum: +

+ + + +
+ +

Modding

+ +

Where do I install mods?

+

+ Mods go into: +

+ +
/opt/valheim/BepInEx/plugins
+ +

Will mods break updates?

+

+ No. The clean install directory (/opt/valheim_base) is kept + separate from the modded runtime directory (/opt/valheim), so + SteamCMD updates are always safe. +

+ +

Where are mod configuration files stored?

+

+ Many mods generate configs under: +

+ +
/opt/valheim/BepInEx/config
+ +
+ +

Backups

+ +

Does the server create backups automatically?

+

+ Yes. The container creates timestamped ZIP backups at a configurable interval + and prunes old backups based on retention settings. +

+ +

Where are backups stored?

+

+ Backups are stored in: +

+ +
/backups
+ +

Does Valheim create its own backups?

+

+ Yes. Valheim maintains up to 5 rolling internal backups in: +

+ +
/root/.config/unity3d/IronGate/Valheim/worlds_local/<WORLD_NAME>
+ +

+ These include files like: +

+ + + +
+ +

Restoring Worlds

+ +

How do I restore from a container backup?

+
    +
  1. Stop the TrueNAS SCALE app.
    2. +
  2. Extract the ZIP file from /backups.
    3. +
  3. Copy the world directory into:
    + /root/.config/unity3d/IronGate/Valheim/worlds_local/<WORLD_NAME> +
    4. +
  4. Start the app.
    5. +
+ +

How do I restore from Valheim’s internal backups?

+
    +
  1. Stop the app.
    2. +
  2. Choose one of the numbered _X.db files.
    3. +
  3. Replace the main .db and .fwl files.
    4. +
  4. Start the app.
    5. +
+ +
+ +

Connectivity

+ +

Why can't players join?

+ + +

Why doesn't the server appear in the browser?

+ + +
+ +

Performance

+ +

Why is the server lagging?

+ + +
+ +

Updates

+ +

Do I need to manually update the server?

+

+ No. SteamCMD updates Valheim automatically on each container start. +

+ +

Do I need to update BepInEx manually?

+

+ No. The container downloads and installs the latest BepInEx pack automatically. +

+ +
+ +

Next Steps

+ + + +

+ This FAQ will expand as new features and versions are released. +