PhValheim Client

The client-side companion to phvalheim-server. PhValheim Client syncs world contexts from a remote PhValheim Server and launches Valheim with the correct BepInEx mod environment for that world.

How it works

PhValheim Server registers a phvalheim:// URL scheme handler on your desktop. When you click a world launch link from the server's web UI, PhValheim Client:

1. Connects to the PhValheim Server and checks if your local world files are in sync
2. Downloads any updated world files (mods, configs, BepInEx) if needed
3. Launches Valheim with the correct BepInEx context, server connection details, and password

Requirements

• Valheim installed via Steam
• Steam running before launching
• A running phvalheim-server

Installation

Debian / Ubuntu (.deb)

sudo dpkg -i phvalheim-client-<version>-x86_64.deb
sudo chmod 755 /usr/bin/phvalheim-client
xdg-mime default phvalheim-client.desktop x-scheme-handler/phvalheim

Fedora / RHEL (.rpm)

sudo rpm -i phvalheim-client-<version>-x86_64.rpm
xdg-mime default phvalheim-client.desktop x-scheme-handler/phvalheim

Universal Linux (.tar.gz)

tar -xzf phvalheim-client-<version>-universal-x86_64.tar.gz
sudo ./phvalheim-client-installer.sh install
xdg-mime default phvalheim-client.desktop x-scheme-handler/phvalheim

macOS

curl -fsSL https://github.com/@raw/brianmiller/phvalheim-client/master/macinstall.sh | bash

This downloads the latest universal binary, installs it to /usr/local/bin/phvalheim-client, and registers the phvalheim:// URL scheme via a .app bundle in /Applications. Works on both Intel and Apple Silicon Macs (Apple Silicon runs Valheim under Rosetta 2 for full mod compatibility).

To uninstall or run diagnostics:

curl -fsSL https://github.com/@raw/brianmiller/phvalheim-client/master/macinstall.sh | bash -s -- uninstall
curl -fsSL https://github.com/@raw/brianmiller/phvalheim-client/master/macinstall.sh | bash -s -- diags

Windows (.msi)

Run the installer. The URL scheme handler is registered automatically.

Uninstalling

Universal Linux

sudo ./phvalheim-client-installer.sh uninstall

Debian / Ubuntu

sudo dpkg -r phvalheim-client

Fedora / RHEL

sudo rpm -e phvalheim-client

Building from source

Requires .NET 9 SDK.

dotnet publish -c Linux-Release -r linux-x64 -p:PublishSingleFile=true --self-contained true ./phvalheim-client.csproj

Package builds use Docker or a remote Mac:

• Debian .deb: bash builders/build_deb-outie
• Fedora .rpm: bash builders/build_rpm-outie
• Universal .tar.gz: bash builders/build_tgz-innie
• macOS .tar.gz: bash builders/build_macos-outie (requires SSH access to a Mac build host)

Related

• phvalheim-server — The server side of PhValheim