phvalheim-server
Docker app from TheBrian's Repository
An over-engineered approach to Valheim server+client world+mods management.
Overview
Readme
View on GitHub
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 → |
▶ 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
Total Downloads Over Time
Related apps
Explore more like this
Explore allLinks
Details
theoriginalbrian/phvalheim-serverRuntime arguments
- Web UI
http://[IP]:[PORT:8081]- Network
bridge- Shell
bash- Privileged
- false
Template configuration
This is the public port PhValheim Server listens on.
- Target
- 8080
- Default
- 8080
- Value
- 8080
This is the admin port PhValheim admin interfaces listen on.
- Target
- 8081
- Default
- 8081
- Value
- 8081
Every Valheim world requires two UDP ports. We reserve a large block.
- Target
- 25000-25100
- Default
- 25000-25100
- Value
- 25000-25100
Internal Container Path: /opt/stateful
- Target
- /opt/stateful
- Default
- /mnt/user/appdata/phvalheim-server
- Value
- /mnt/user/appdata/phvalheim-server
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