Valheim Incompatible Version Error

From Survival Servers
Revision as of 09:17, 17 November 2026 by Ryan (talk | contribs) ([wiki:wiki-operator] Reworded to the house writing rules; facts that were wrong today corrected (approved by Ryan, Nov 17))
Jump to navigation Jump to search

The Valheim "Incompatible version" error usually means the game you're running and the server you're 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 game connect to a server that reports the same network version. The fix is to bring both 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 don't match, the join is refused with "Incompatible version". Nothing on the server is broken and nothing is lost. One side is 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 the Game Server page in the Command Center.

Which side is behind decides the fix:

  • Steam updated your game and the server didn't update. The most common case, especially in the hours after a patch. The server needs the update.
  • The server updated and your game didn't. Steam hasn't 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 doesn't 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 Command Center still shows the old version afterwards, run the update once more with Yes, run update/validate. A patch that comes out 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 isn't:

  1. Close Valheim completely.
  2. In Steam, right-click Valheim, then Properties, Installed Files, and Verify integrity of game files. Steam downloads anything that's 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. One is default_old (the previous stable build). When Iron Gate runs one, there's also a public test branch that runs ahead of the release. A game on another branch can't 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. On a self-hosted server, that's a -beta option on the SteamCMD line, for example -beta default_old. Remove it and run the update to go back 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

Mods on the server such as Valheim Plus and many BepInEx mods compare their own version between the server and each player's game. A server running a mod your game doesn't have, or a different version of it, refuses the join with the same "Incompatible version" message even when 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 isn't 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 won't get in.

Valheim Plus has an Enforce Mod Version Check option in its configuration. Turning it off lets players with a slightly different Valheim Plus version join. It does nothing for a game version mismatch.

Crossplay and console players

Iron Gate releases each patch on 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's nothing to fix on the server: only the platform's own update fixes it. How to set up crossplay: How to Set Up a Valheim Crossplay Server.

Valheim 1.0 on September 9, 2026

Valheim 1.0 came out on September 9, 2026, and it was the largest version change the game has had. Steam updates every player's game as soon as the build is live. A server still on the previous build refuses those players with "Incompatible version" until it's 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 don't need a new world. How to move a world between your PC and a server: 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.