Alpha Game Server Manager

Dedicated server guide

Valheim

Manage valheim with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Recorded lifecycle pass · Support evidence: 2026-10-16.

Build setup commands
Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

2456/UDP, 2456/TCP, queryport/UDP, queryport/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Mods and plugins

Declared curated families: bepinex. The optional bepinex example installs its dependencies and applies the mod plan before launch.

Backup hook

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Choose a supported runtime

Linux and Docker quickstart

Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup. Optional curated example: bepinex. Omit all optional mod steps for a base server.

  1. Start the Docker manager ./alphagsm-docker start
  2. Create the game instance ./alphagsm-docker my-valheim create valheim
  3. Complete interactive setup ./alphagsm-docker my-valheim setup
  4. Optional: add bepinex # Optional curated mod: bepinex; add bepinex ./alphagsm-docker my-valheim mod add manifest bepinex
  5. Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm-docker my-valheim mod apply
  6. Start the game server ./alphagsm-docker my-valheim start
  7. Check the instance status ./alphagsm-docker my-valheim status
./alphagsm-docker start
./alphagsm-docker my-valheim create valheim
./alphagsm-docker my-valheim setup
# Optional curated mod: bepinex; add bepinex
./alphagsm-docker my-valheim mod add manifest bepinex
# Optional: apply the mod plan
./alphagsm-docker my-valheim mod apply
./alphagsm-docker my-valheim start
./alphagsm-docker my-valheim status

Host process

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup. Optional curated example: bepinex. Omit all optional mod steps for a base server.

  1. Create the game instance ./alphagsm my-valheim create valheim
  2. Complete interactive setup ./alphagsm my-valheim setup
  3. Optional: add bepinex # Optional curated mod: bepinex; add bepinex ./alphagsm my-valheim mod add manifest bepinex
  4. Optional: apply the mod plan # Optional: apply the mod plan ./alphagsm my-valheim mod apply
  5. Check the host prerequisites ./alphagsm my-valheim doctor
  6. Start the game server ./alphagsm my-valheim start
  7. Check the instance status ./alphagsm my-valheim status
./alphagsm my-valheim create valheim
./alphagsm my-valheim setup
# Optional curated mod: bepinex; add bepinex
./alphagsm my-valheim mod add manifest bepinex
# Optional: apply the mod plan
./alphagsm my-valheim mod apply
./alphagsm my-valheim doctor
./alphagsm my-valheim start
./alphagsm my-valheim status

This guide covers the valheim module in AlphaGSM.

valheim is currently PASSED in the checked-in support tracker. On the documented Ubuntu 24.04 Linux baseline, the current smoke and GitHub integration coverage runs through the shared steamcmd-linux Docker runtime, while local host-process flows remain the fallback path documented elsewhere in the repo. Query/info use the live primary UDP game-port surface rather than requiring a stale A2S response.

Requirements

  • Docker for the validated Linux runtime path
  • For process mode: screen
  • SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
  • Runtime libraries libatomic1, libpulse0, and libpulse-dev
  • Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myvalheim create valheim

Run setup:

alphagsm myvalheim setup

Start it:

alphagsm myvalheim start

Check it:

alphagsm myvalheim status

Stop it:

alphagsm myvalheim stop

Setup Details

Setup configures:

  • the game port (default 2456)
  • the adjacent server port (default 2457)
  • the install directory
  • SteamCMD downloads the server files

Useful Commands

alphagsm myvalheim update
alphagsm myvalheim backup

Notes

  • Module name: valheim
  • Default port: 2456
  • Network protocol: UDP; Docker publishes the primary and adjacent ports
  • Readiness marker: Game server connected
  • query, info, and info --json use generic UDP health on the primary game port

Server variables

After create valheim, inspect or change these with set:

alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE
Key Aliases Type What it does
serverpassword sv_password, password string Password required to join the server. Stored as a secret.

Framework and world reset

Install the pinned BepInEx pack, then start the server. AlphaGSM points run_bepinex.sh at valheim_server.x86_64.

alphagsm myvalheim mod add manifest bepinex
alphagsm myvalheim mod apply

wipe deletes worlds. wipe --mode hard reinstalls the server and keeps adminlist.txt, bannedlist.txt, and permittedlist.txt.

Developer Notes

Run File

  • Executable: valheim_server.x86_64
  • Location: <install_dir>/valheim_server.x86_64
  • Engine: Custom (SteamCMD)
  • SteamCMD App ID: 896660

Server Configuration

Maps and Mods

  • Map directory: Check game documentation
  • Mod directory: Check game documentation
  • Workshop support: No

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

Share your server

Sector Alpha server directory

When your server is ready, you can publish its connection details and community information on Sector Alpha. Review your listing and keep the information current.

Find a community

Browse the directory for game servers and their published connection details.

Browse server directory

Publish your server

Prepare a name, address and description for your listing.

Publish a server

Manual server sharing instructions

Frequently asked questions

What support evidence is recorded for Valheim?

Recorded lifecycle pass. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Which runtimes can run Valheim?

Declared runtimes: Docker or a Linux host process.

Which ports does Valheim use?

2456/UDP, 2456/TCP, queryport/UDP, queryport/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Can I add mods to Valheim?

Declared curated families: bepinex. The optional bepinex example installs its dependencies and applies the mod plan before launch.

How should I back up Valheim?

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Source and support evidence

This guide mirrors AlphaGSM’s upstream documentation at 32cef5ba9e03053c8e461fffa0ba133b160b528d. Commands and prerequisites can change. Check current support notes before installation.

All game guides