phvalheim-server

phvalheim-server

Docker app from TheBrian's Repository

An over-engineered approach to Valheim server+client world+mods management.

Overview
An over-engineered approach to Valheim server+client world+mods management.

PhValheim

Your worlds. Your friends. Your mods.

PhValheim hosts your Valheim worlds and keeps your group's mods in sync.
Manage everything in your browser. Spend more time playing.

PhValheim is free and will always be free. I make no profit from PhValheim users or operators. This is simply my contribution to a game I love. — Brian

Read the guides · Play on our servers · Latest release · Join Discord

Latest: 2.62 — Remote Access, player themes and redesigned settings. Built-in public website access through Tailscale Funnel or Cloudflare, independent login and player themes, personal mod settings and a dedicated Server Settings page. Update modded worlds after upgrading; overlay controls and personal settings need Client 2.0.18. Release notes

Where would you like to start?

I'm hosting I'm playing I have a mod idea
Bring up a server and create your first world. Install the client, sync and join your friends. Let Hugin help you write, build and package it.
Set up a server → Join a world → Make your first Vibe →

Watch PhValheim: worlds, mods, configuration and client syncing
▶ PhValheim in one minute — Host. Mod. Sync. Play.

Less setup between you and the next adventure

  • Vanilla and modded worlds together. Run several worlds from one Docker container.
  • The same mods for the whole party. Choose from Thunderstore, Hexium and your own local catalogue. Players sync through the PhValheim client before launching.
  • A home for the day-to-day work. Access lists, backups, restores, updates, configurations and logs in one admin UI.
  • A raven with useful skills. Ask Hugin to investigate server problems and propose changes, or use his Vibes workshop to create mods. Hosted and self-hosted AI providers are optional.

Meet Hugin's Vibes

“Make a small stamina tweak with a setting I can change later.”

Start with an idea. Hugin writes C#, runs the compiler and works through build feedback with you. The optional Build Pak prepares the tools and references, using game libraries from your own installed world.

Each Vibe has its own local Git repository. Package the plugin and publish it to your Hugin's Vibes catalogue, then select it on a test world, update, sync and play. Import from GitHub or GitLab when you want to bring an existing project along.

Ready to host?

Use Docker Compose, Unraid or Kubernetes. The setup wizard handles the settings after the container starts.

For Portainer on Linux x86-64 Docker Standalone, follow the Portainer stack guide for deployment and private admin access.

Image: theoriginalbrian/phvalheim-server:latest

Keep /opt/stateful persistent and the admin UI private. The install guide includes a ready-to-copy Compose file, storage paths, ports and first-run steps.

Already running a server?

Update PhValheim · Manage mods · Back up a world · Troubleshoot

Need help? Ask on Discord or report an issue.

PhValheim Client · Companion · Changelog · Contributing · Contribute to the docs

License

Original PhValheim code owned by Brian Miller is available under the MIT License. Third-party code, game assets and media retain their own licenses and notices; the MIT declaration does not relicense those components.

The bundled Database Browser uses GridPHP under its separate license. The product tour's music is licensed under CC BY 4.0; preserve its attribution when sharing the video.

Categories

Download Statistics

55,640
Total Downloads
9,566
This Month
5,581
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Links

Details

Repository
theoriginalbrian/phvalheim-server
Last Updated2026-10-28
First Seen2022-08-03

Runtime arguments

Web UI
http://[IP]:[PORT:8081]
Network
bridge
Shell
bash
Privileged
false

Template configuration

PhValheim Public Web Sever PortPorttcp

This is the public port PhValheim Server listens on.

Target
8080
Default
8080
Value
8080
PhValheim Admin Web Sever PortPorttcp

This is the admin port PhValheim admin interfaces listen on.

Target
8081
Default
8081
Value
8081
PhValheim Game Server PortsPortudp

Every Valheim world requires two UDP ports. We reserve a large block.

Target
25000-25100
Default
25000-25100
Value
25000-25100
Stateful Data PathPathrw

Internal Container Path: /opt/stateful

Target
/opt/stateful
Default
/mnt/user/appdata/phvalheim-server
Value
/mnt/user/appdata/phvalheim-server
Stateful Data Path for backupsPathrw

Internal Container Path for backups: /opt/stateful/backups

Target
/opt/stateful/backups
Default
/mnt/user/appdata/phvalheim-server/backups
Value
/mnt/user/appdata/phvalheim-server/backups