necc/valheim-server
Watch
1
0
Fork
You've already forked valheim-server
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
17 commits 1 branch 0 tags 35 KiB
  • Shell 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
necc f048d60a94 Update README.md
2026-09-20 14:48:15 +02:00
docker-compose.yml Update docker-compose.yml 2026-09-20 12:56:02 +02:00
generate-secrets.sh Add generate-secrets.sh 2026-09-12 14:39:18 +02:00
LICENSE Initial commit 2026-09-12 13:41:16 +02:00
README.md Update README.md 2026-09-20 14:48:15 +02:00
stack.env Update stack.env 2026-09-12 14:21:44 +02:00

README.md

Valheim Dedicated Server

Dedicated multiplayer server for Valheim — survival action-RPG set in Norse mythology. Bundles a supervisor web UI, automatic updates, idle restarts, and scheduled world backups.

Prerequisites

Requirement Details
Docker secrets bash generate-secrets.sh
External network proxiable-valheim external bridge for HTTP admin and stat interfaces (must already exist before deploying this stack!)

Docker Engine version must be >= 29.4.3

Deployment — Portainer → Add Stack → Git Repository

  1. Portainer → Stacks → Add stack

  2. Name the stack (e.g. valheim)

  3. Select Git repository as the source

  4. Fill in:

    Field Value
    Repository URL https://git.necc.me/necc/valheim-server.git
    Repository reference refs/heads/main
    Compose file path docker-compose.yml

  5. Environment variables — copy the contents of stack.env from this repository and paste them into the Environment variables section. Adjust values as needed (server name, ports, paths, etc.).

  6. Click Deploy the stack

Note: stack.env is an example/template. Portainer-CE does not auto-process it for Git-backed stacks — you must paste its contents into the Environment variables field.

Updating

Action How
Pull latest code / image Stacks → valheim → Pull and redeploy
Change a variable Edit in Portainer's Environment variables, then Pull and redeploy
Change compose Edit in the Git repo → push → Pull and redeploy

Access

Service Proxy target Protocol
Supervisor UI valheim:9001 HTTP (proxied)
Status JSON valheim:80 HTTP (proxied)
Game traffic host UDP 2456–2458 UDP (direct)

Your reverse proxy must be attached to the proxiable-valheim external network to resolve valheim by container name.