Skip to content

PhValheim Client 2.0.19 — all-platform prerelease

Pre-release
Pre-release

Choose a tag to compare

@brianmiller brianmiller released this 19 Nov 20:17

2.0.19 is a prerelease for testing, for Windows, Linux (DEB, RPM, TGZ, Flatpak) and macOS.
This broader revision handles Hidden mod configuration, player-setting preservation
and sync records as well as loader/backend files, addressing
issue #25.
Live Valheim gameplay with this revision remains unverified.

PUBLISHED — broader revision, November 20, 2026. Seven packages were replaced;
macinstall.sh is unchanged. All nine public downloads, fetched without authentication,
are byte-identical to the release files, including SHA256SUMS; all eight checksum
entries passed.
2.0.18 remains stable, including normal installer and “latest” links.

Already installed 2.0.19?

Redownload and reinstall your 2.0.19 package on every platform. The version and
filenames are unchanged. Verify SHA-256 against the table
below before installing: the new and previous MSIs are both 32,899,072 bytes, so
size cannot distinguish them. Native upgrades from both earlier 2.0.19 ProductCodes
are verified for this exact MSI.

For an existing RPM installation, explicitly replace the same-version package:

sudo rpm -Uvh --replacepkgs ./phvalheim-client-2.0.19-x86_64.rpm

Downloads and SHA-256

These are the published broader revision sizes and hashes. All eight entries in the release
SHA256SUMS
passed against the unauthenticated public downloads, which match the release files byte for byte.

Platform / format Artifact Bytes SHA-256
Windows MSI phvalheim-client-2.0.19-x86_64.msi 32,899,072 6816a959190a3a4eedbd5fbe4cab15348c9fc10c8345699f9c098d8e8b611ab5
Linux DEB phvalheim-client-2.0.19-x86_64.deb 23,605,832 7d4e2233a124702c54c6fb31feaea22b205bfad6ae8586f2471a9e49d2ad1740
Linux RPM phvalheim-client-2.0.19-x86_64.rpm 25,715,981 af17b34c63a1c242345f1674b09e58c0574aeac3c29a546aeb0463a0ce9fe1b9
Linux TGZ phvalheim-client-2.0.19-universal-x86_64.tar.gz 31,442,762 3f956daa86f0c0a4b1b59545bf600afdf8c4245be6fd029aeb9601a9cc42d77a
Linux Flatpak phvalheim-client-2.0.19-x86_64.flatpak 23,330,920 4356e8698004915512403cc6bd61a9085bb1b417e1d77c1b49460c07a80fe2d5
macOS universal TGZ (primary) phvalheim-client-2.0.19-macos-universal.tar.gz 61,777,898 d0279d41ccaa7aea0f80d2e5a64449be77f6af1f5f10677be2a9df86c58fc24b
macOS universal PKG (supplementary) phvalheim-client-2.0.19-macos-universal.pkg 61,781,848 b62d282b165030b5a424e8e5752ca1ea8d6bb6d1643e73850863c0c2e65bbdb3
macOS shell installer macinstall.sh 9,355 13c8894e2d76e0cebb1a6b097c7dbbd175a420175a134c65d2374299f748d925

macOS uses the shell installer plus universal TGZ as its primary installation method;
the PKG is supplementary. The normal installer selects stable 2.0.18.
Download the installer and tarball into the same folder, verify their hashes above,
and explicitly select the 2.0.19 tarball:

curl -fLO https://github.com/brianmiller/phvalheim-client/releases/download/2.0.19/macinstall.sh
curl -fLO https://github.com/brianmiller/phvalheim-client/releases/download/2.0.19/phvalheim-client-2.0.19-macos-universal.tar.gz
PHVALHEIM_TARBALL=./phvalheim-client-2.0.19-macos-universal.tar.gz bash ./macinstall.sh install

For Linux DEB and TGZ, follow the README installation commands
with version 2.0.19; for RPM use the replacement command above. For Flatpak:

flatpak install --user --reinstall ./phvalheim-client-2.0.19-x86_64.flatpak

On Windows, run the downloaded MSI.

What changed

Windows managed writes now handle Hidden files during mod-config policy enforcement,
personal-setting application and preservation, and sync-record updates, in addition to
winhttp.dll, doorstop_config.ini and phvalheim.backend. Existing-file overwrites
preserve Hidden attributes and existing ACLs. Personal config retains Hidden through
staged updates; sync records and game-directory loader files also retain Hidden.
A full world regeneration recreates cache/backend files with fresh metadata, so their
previous Hidden flags are not expected to survive that lifecycle.

The client does not scan for and unhide files, reset permissions, clear ReadOnly, or
request elevation. ReadOnly still aborts protected updates; a genuinely denied backend
write still aborts launch. Reparse-point destinations are rejected. Managed writes stage
contents before replacement; failed staging preserves the original. Staging does not
guarantee protection against external races or power loss.

Windows loader installation copies only winhttp.dll and doorstop_config.ini,
skipping files intended for other platforms. Linux selects libdoorstop_x64.so
and the config; macOS copies no loader files into the signed Valheim.app bundle.
Ordinary macOS copies also preserve the destination's Hidden flag.

Diagnostics and troubleshooting

Path-specific diagnostics retain the failing operation, exception type, message,
and hexadecimal HResult, plus file attributes, Windows owner/ACL observations,
and a temporary parent-directory write probe where available. Unavailable observations
remain unknown; these observations do not establish antivirus or Controlled Folder Access as the cause.

Diagnostics, persistent logs, and disk-space checks are available on all platforms:

Platform Normal diagnostic log
Windows %APPDATA%\PhValheim\logs\phvalheim-client.log
Linux ~/.config/PhValheim/logs/phvalheim-client.log
macOS ~/Library/Application Support/PhValheim/logs/phvalheim-client.log

Logs redact credentials and rotate at 1 MiB and at the start of each run, retaining
up to three archives. If the normal location fails, the client tries a temporary
fallback. Use the actual path printed in the error; if both locations fail, logging
is reported as unavailable. Review logs before sharing: local paths and usernames may remain.

Disk-space preflight checks the destination volume for downloads, archive/config
staging, loader copies, and backend writes. It reports required additional bytes
and available space where measurable; unknown sizes remain unknown, and estimates
do not guarantee an update will fit. Failed staged updates preserve the installed
world; failed download transport preserves the cached archive.

Published revision validation

  • Native actual-client source validation 44643769336: SUCCESS. All 11 Hidden-file targets passed, with a published-executable negative control and a ReadOnly control. This is source validation, not validation of the new MSI.
  • Full source CI 44648623221: all 15 jobs succeeded.
  • Published MSI local validation: 81 structural, 24 executable smoke, and 36 Wine behavior checks passed. Wine repair was SKIPPED; native Windows repair PASSED.
  • Exact packaged Windows validation 44647729127: the 11-target Hidden-file actual-client fixture and previous-correction 2.0.19 migration, 14 checks both SUCCEEDED. Upgrades from 2.0.12 through 2.0.18, native repair, the wizard and negative control also SUCCEEDED. The initial workflow failed overall only in the original 2.0.19 migration job, because of a COM test-harness bug.
  • Targeted native Windows rerun 44649449411 at 47790c96adac024cb7f2d6f66bf49e2795c5fcd5: SUCCESS, with 14 original-2.0.19 migration checks and 20 installer-condition cases. It tested the same unchanged MSI (6816a959…), completing the native Windows gate and verifying migration from both known 2.0.19 predecessors.
  • Linux DEB, RPM and TGZ each passed 13 upgrade/removal checks from stable 2.0.18. Same-version 2.0.19 DEB and TGZ reinstalls each passed 13 checks; RPM reinstall with --replacepkgs passed exact-binary verification.
  • Flatpak passed 42 package, 88 runtime/browser, 46 native pass-through, 16 stable-2.0.18 upgrade, and 16 prior-2.0.19 upgrade checks.
  • Native macOS validation 44646602998: SUCCESS, with 15 checks in each of four candidate installation scenarios and 7 URL-handler checks in each of three phases. Native execution was Apple Silicon only.

Validation limits

No Intel Mac runtime validation or actual Valheim gameplay validation was performed.
No Bazzite-specific validation is claimed.
Recording Steam/game stubs establish handoff only, not live gameplay or graphics behavior.
The affected player's earlier gameplay confirmation followed manually clearing Hidden
flags; it does not establish that this revision resolves their failure. Real antivirus
and Controlled Folder Access behavior remain unverified.

Build provenance and superseded candidates

The version remains 2.0.19. Runtime source is
9d4c1fbb8db2cf1a4476f6cb05c113764c1fefe5.
Windows, Linux and macOS binaries were built from
4314ddedcea800e1faea9be330f401c66c8d3490,
whose runtime source is identical to 9d4c1fb. MSI packaging source is
c821d1f0b29aab59c16ca440a0e74e82588bc70c.
The new packaged executable SHA-256 is
72e717f34381ea04246fdd695e8e6119dba1c16eaf9ab2972072683507017ca8.

Source PR #28 remains unmerged.
The numeric 2.0.19 tag is unchanged at
6204fe1103f8c7f5e26bcd833e84d16e8cf2dc33
and does not identify the replacement builds. Stable 2.0.18 and master are unchanged.

All three MSI candidates use phvalheim-client-2.0.19-x86_64.msi:

Candidate Bytes ProductCode MSI SHA-256
Original (superseded) 32,886,784 3783EF6D-25B9-4A61-9518-BE79B530643A 7e48a17e1b9921360ffeaab77d34cea1b7243ac3eb4e0ac0a569b4f0432dc488
Previous correction (superseded) 32,899,072 9ED226DE-BDBE-4D21-A0F3-C0422155FA22 260c78168955438b03d7b0684a83990db76c82dcf4de59c05820abacee4e949a
Broader revision (published November 20) 32,899,072 1C3D3C32-C803-499D-ABAD-1DEB717AFED3 6816a959190a3a4eedbd5fbe4cab15348c9fc10c8345699f9c098d8e8b611ab5

Immutable copies: original MSI at 3e63990
and previous MSI at 2a1f673.
The published MSI retains ProductCode 1C3D3C32-C803-499D-ABAD-1DEB717AFED3;
native upgrades from both superseded ProductCodes passed with this exact package.
Unknown same-version products and newer versions remain blocked. It retains the
existing self-signed publisher certificate; Windows may show an unknown publisher.

The previous correction's executable SHA-256 was
d692bf7312e2a6fc307af47406110e0c592fab3c3a57ea98e5bf9aa80de4fec1,
built from 1d6d7c93c8dc4c58a6ca6d4401b3075e6837ecb7.
Its Linux packages came from
2a1f673e1940c121173aea0e10e2b8e4cd4e4006
with identical runtime source; its native macOS packages came from
ed63f413275d7520e7ca038d64581b86be8aef5c,
differing only in workflow configuration. Historical
native file validation 44619866045,
installer validation 44620112640,
actual-client validation 44622099219,
native macOS validation 44634732509
and post-publication validation 44635781414
refer to those superseded packages, not this broader revision. The old installer run
had a failing Hidden-file fixture; the later actual-client run covered its corrected
loader/backend payload.