Valheim Incompatible Version Error
The Valheim "Incompatible version" error means one thing: the game you are running and the server you are joining are on different builds. Valheim only lets a client connect to a server on the same version, so the fix is always to bring the two sides to the same build. This guide covers every common cause, in the order to try them.
What the error means
Every Valheim update changes the version the game reports to servers. When you pick a server in the Join Game list and the versions do not match, the join is refused with "Incompatible version". Nothing on the server is broken and nothing is lost; one side is simply behind.
The version number is shown in the bottom left corner of the Valheim main menu. A dedicated server prints its version in the console window when it starts, and a hosted server shows it in the control panel.
Which side is behind decides the fix:
- Steam updated your game and the server did not update. The most common case, especially in the hours after a patch. The server needs the update.
- The server updated and your game did not. Steam has not applied the patch to your copy yet, usually because the game was open when the patch went live. The game needs the update.
- Both are current and it still fails. One side is on a beta branch, or a mod is changing the version the game reports. See fixes 3 and 4.
Fix 1: Update the server
Self-hosted dedicated server
A dedicated server installed with SteamCMD does not update itself. Stop the server, then run the same install line you used to set it up:
steamcmd.exe +force_install_dir "C:\Valheim\ValheimServer" +login anonymous +app_update 896660 validate +quit
Wait for "Success! App '896660' fully installed", then start the server again. The validate option also repairs any damaged file. The full install and start steps are in How to Create a Valheim Server Guide.
Rented server
On a hosted server the update is a button in the control panel. Stop the server, run the update, and start it again. If the panel still shows the old version afterwards, run the update once more with file validation; a patch that lands while the server is starting can leave it half applied.
Note: Players who update before the server does will see "Incompatible version" until the server has been updated. Update the server first whenever you can.
Fix 2: Update or verify the game
If the server is on the current build and your game is not:
- Close Valheim completely.
- In Steam, right-click Valheim, then Properties, Installed Files, and Verify integrity of game files. Steam downloads anything that is missing or out of date.
- If Steam shows the update as queued or paused, open the Downloads page and start it.
- Start Valheim and check the version number in the bottom left of the main menu.
The Microsoft Store and Game Pass versions update through the Xbox app instead. Console versions update through the console's own store.
Fix 3: Match the Steam beta branch
Valheim has a public test branch on Steam that runs ahead of the normal release. A game on the public test branch cannot join a server on the release branch, and the other way round, because they are different builds.
To check: in Steam, right-click Valheim, Properties, Betas. For a normal server the branch must be None. If you opted into the public test to try new content, switch back to None and let Steam download the release build.
A dedicated server can be on the public test branch too. Self-hosted, that is the -beta public-test -betapassword yesimadebackups addition to the SteamCMD line; remove it and run the update to return to the release branch. On a rented server, check the control panel for a branch or public test option. Every player and the server must be on the same branch.
Fix 4: Mods that change the version
Server side mods such as Valheim Plus and many BepInEx mods compare their own version between client and server. A server running a mod your game does not have, or a different version of it, refuses the join with the same "Incompatible version" message even though the game builds match.
- If the server runs Valheim Plus, every player needs the same Valheim Plus version installed. See How to Install Valheim Plus.
- If the server was meant to be unmodded, remove the mod from the server. On a hosted server, set the mod option back to none and restart.
- After a game update, mods often break until their authors update them. A modded server needs the mod updated as well as the game, and until then even a fully updated vanilla game will not get in.
Valheim Plus has an Enforce Mod Version Check option in its configuration. Turning it off lets clients with a slightly different Valheim Plus version join. It does nothing for a game version mismatch.
Crossplay and console players
Iron Gate ships each patch to Steam first. The Microsoft Store, Game Pass, Xbox, PlayStation 5 and Nintendo Switch 2 builds sometimes follow hours later, occasionally longer. On a crossplay server, players on those platforms see "Incompatible version" from the moment the server updates until their platform receives the same patch. There is nothing to fix on the server; the platform update is the only cure. Setting up crossplay is covered in How to Set Up a Valheim Crossplay Server.
Valheim 1.0 on September 9, 2026
Valheim 1.0 rolls out on September 9, 2026, and it is the largest version change the game has had. Steam updates every client as soon as the build is live. A server still on the previous build refuses those clients with "Incompatible version" until it is updated, so on launch day the order matters: update the server, then let players update and join.
After the update, check the version number in the main menu. The server must report the same number before anyone can join.
Existing worlds carry over into 1.0. You do not need a new world, and moving a world between your PC and a server is covered in How to Download Your Valheim World.
Quick checklist
- Compare the version in your main menu with the server's version.
- Update whichever side is behind. Server: SteamCMD or the control panel. Game: Steam verify.
- Check that the Steam beta branch is None on both sides.
- Check for mods on the server and match them on the game, or remove them.
- Console or Game Pass player: wait for that platform's patch.
See also
- How to Create a Valheim Server Guide
- How to Join a Valheim Server
- How to Set Up a Valheim Crossplay Server
- How to Download Your Valheim World
- How to Install Valheim Plus
- Valheim Admin Commands
On a Survival Servers Valheim server this whole fix is the Update button in the control panel, and a restart from the panel pulls the current build as well.