Repository navigation
2.0.13
Confirmed working on real hardware: a modded world synced, launched and loaded all its mods correctly on Omarchy (Arch + Hyprland). Not yet confirmed on SteamOS or Bazzite specifically — reports welcome.
New: Linux Flatpak
For SteamOS, Bazzite and other immutable gaming distros where a .deb or .rpm is awkward or impossible (phvalheim-server#86).
flatpak install --user ./phvalheim-client-2.0.13-x86_64.flatpakOn Hyprland, Sway, i3 and other bare window managers, also run this once and log out and back in — otherwise clicking a world link silently does nothing. GNOME and KDE don't need it:
mkdir -p ~/.config/environment.d && printf 'XDG_DATA_DIRS=/usr/local/share:/usr/share:/var/lib/flatpak/exports/share:%s/.local/share/flatpak/exports/share\n' "$HOME" > ~/.config/environment.d/flatpak.confThat puts Flatpak's applications directory on your session's search path, so the phvalheim:// handler can be found. It is needed by every Flatpak you install, not this one in particular, and a Flatpak cannot do it for you — an app can't edit its own session's environment. Confirm after logging back in:
gio mime x-scheme-handler/phvalheim # should print com.phvalheim.Client.desktopTo exercise the client without any desktop wiring, copy a world's launch link from the server web UI (right-click → Copy Link Address):
flatpak run com.phvalheim.Client '<paste the phvalheim:// link here>'Notes
Synced worlds live in ~/.config/PhValheim, the same place the .deb and .rpm use, so switching package format keeps your worlds.
Works with a system Steam (what SteamOS and Bazzite ship). A Steam installed as a Flatpak (com.valvesoftware.Steam) is also supported, but that path is untested — details and what to report. Steam libraries under home, /run/media, /media and /mnt work out of the box — that covers Steam Deck SD cards. For anywhere else:
flatpak override --user --filesystem=/your/library/path com.phvalheim.ClientThis package is not meaningfully sandboxed — launching Valheim means running host programs and reading your Steam library. docs/FLATPAK.md lists every permission and why it is there.
Also in 2.0.13
- Vanilla world support — zero-mod worlds launch through Steam's own
+connect. Valheim has no client-side password argument, so the password is printed for you to type. - Windows installer rebuilt from scratch. The
.msinow builds headlessly on Linux viawixl; the Visual Studio Setup Project is retired. Fixes along the way: the installer wizard silently vanishing, missing and unstyled wizard text, error 2834 on Cancel, and an upgrade that deleted the executable. - macOS ships as a universal build for Apple Silicon and Intel, with Apple Silicon running Valheim under Rosetta 2 for full mod compatibility. The
.pkgis replaced bymacinstall.sh. Earlier builds shipped an Apple-Silicon-only URL handler, sophvalheim://links did not work on Intel Macs; they do now. - No more crash when Steam's library list is missing — you get a message instead of a stack trace.
Platform notes
-
macOS: install or upgrade with
curl -fsSL https://raw.githubusercontent.com/brianmiller/phvalheim-client/master/macinstall.sh | bashThe build is universal — Apple Silicon and Intel. If you installed on macOS between this release going Latest and 2026-09-23 and your client still reports 2.0.12, you got a placeholder tarball that was standing in for a build we could not produce at the time; re-run the command above to get the real 2.0.13.
-
The
.msiis signed with a self-signed certificate, so SmartScreen warns about an unknown publisher — More info → Run anyway. -
Steam Deck Game Mode has no terminal, so a launch there shows no progress output.