Valheim Incompatible Version Error: Difference between revisions

From Survival Servers
Jump to navigation Jump to search
[wiki:ss-claude-11372] Fixes: wrong or outdated steps, labels and facts corrected, current pictures, dead links fixed, search title and description
[wiki:wiki-operator] Patch 1.0.20 (October 15, 2026) moved to network version 41 (Ryan yes 10/27)
Line 70: Line 70:
Valheim 1.0 rolled out on September 9, 2026, and it was 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 mattered: update the server, then let players update and join.
Valheim 1.0 rolled out on September 9, 2026, and it was 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 mattered: update the server, then let players update and join.


The 1.0 launch build reported version 1.0.7 (network version 39) in the bottom left of the main menu (Steam dedicated server build 25185644, published September 9, 2026 at 6:00 AM PDT). Hotfix 1.0.12 on September 11, 2026 moved to network version 40, which 1.0.17 still uses. The server must show the same network version before anyone can join.
The 1.0 launch build reported version 1.0.7 (network version 39) in the bottom left of the main menu (Steam dedicated server build 25185644, published September 9, 2026 at 6:00 AM PDT). Hotfix 1.0.12 on September 11, 2026 moved to network version 40, and Patch 1.0.20 on October 15, 2026 moved to network version 41. The server must show the same network version 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]].
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]].

Revision as of 15:45, 27 October 2026

The Valheim "Incompatible version" error usually means the game you are running and the server you are joining are on different builds. Mismatched required mods (Valheim Plus, BepInEx mods) cause the same error even when the base game versions match. Valheim only lets a client connect to a server that reports the same network version, so the fix is to bring the two sides to the same build, and the same mod versions if you run mods.

What the error means

Many Valheim updates change the network 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 Survival Servers server shows it under SERVER DETAILS on its page in the Command Center.

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 Survival Servers server the update is the Server Update setting in the Command Center. Set it to Yes, run update and press Save Settings & Restart. If the panel still shows the old version afterwards, run the update once more with Yes, run update/validate; a patch that lands while the server is starting can leave it half applied.

Note: 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:

  1. Close Valheim completely.
  2. 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.
  3. If Steam shows the update as queued or paused, open the Downloads page and start it.
  4. 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 other branches on Steam besides the normal release, such as default_old (the previous stable build) and, when Iron Gate runs one, a public test branch that runs ahead of the release. A game on another branch cannot join a server on the release branch, and the other way round, when their network versions differ.

To check: in Steam, right-click Valheim, Properties, Game Versions & 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 another branch too. Self-hosted, that is a -beta addition to the SteamCMD line, for example -beta default_old; remove it and run the update to return to the release branch. On a Survival Servers server, the branch is the Game Branch setting in the Command Center, where Stable release (recommended) is the normal release. 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 Survival Servers server, set Mod to No Mod, or to ValheimOne if No Mod is not offered (players need nothing for it), and press Save Settings & 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 often follow a few days later. On a crossplay server, when a patch changes the network version, 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 rolled out on September 9, 2026, and it was 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 mattered: update the server, then let players update and join.

The 1.0 launch build reported version 1.0.7 (network version 39) in the bottom left of the main menu (Steam dedicated server build 25185644, published September 9, 2026 at 6:00 AM PDT). Hotfix 1.0.12 on September 11, 2026 moved to network version 40, and Patch 1.0.20 on October 15, 2026 moved to network version 41. The server must show the same network version 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

  1. Compare the version in your main menu with the server's version.
  2. Update whichever side is behind. Server: SteamCMD or Server Update in the Command Center. Game: Steam verify.
  3. Check that the Steam beta branch is None on both sides.
  4. Check for mods on the server and match them on the game, or remove them.
  5. 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 Server Update setting in the Command Center: pick Yes, run update and press Save Settings & Restart.