# Update Mods on Your Valheim Server (/docs/valheim/update-mods)



import { Step, Steps } from 'fumadocs-ui/components/steps';

When Valheim receives a game update, you'll often need to update your mods to match. Outdated mods can cause crashes, connection failures, and version mismatch errors.

When to Update Mods [#when-to-update-mods]

| Trigger                            | Why                                           |
| ---------------------------------- | --------------------------------------------- |
| **Valheim received a game update** | Mods may be incompatible with the new version |
| **A mod releases a new version**   | Bug fixes, new features, compatibility        |
| **Players can't connect**          | Client/server mod versions out of sync        |
| **Server crashes on startup**      | Often caused by outdated mods                 |

Update via the Panel Mod Manager [#update-via-the-panel-mod-manager]

<Steps>
  <Step>
    Open the Mod Manager [#open-the-mod-manager]

    In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Mods** in the sidebar.

    {/* Screenshot needed: Sidebar with Mods entry */}
  </Step>

  <Step>
    Open the Installed Mods tab [#open-the-installed-mods-tab]

    Switch to the **Installed Mods** tab.

    {/* Screenshot needed: Installed Mods tab with update buttons */}
  </Step>

  <Step>
    Look for updates [#look-for-updates]

    Mods that have a newer version show a blue **Update** button. Mods that are current show **Up to date**.
  </Step>

  <Step>
    Update each mod [#update-each-mod]

    Click **Update** on each outdated mod and confirm the dialog. The new version downloads and replaces the old one.
  </Step>

  <Step>
    Restart the server [#restart-the-server]

    Go to **Console** and restart for the updates to apply.
  </Step>
</Steps>

After a Valheim Game Update [#after-a-valheim-game-update]

When Valheim itself receives an update, follow this sequence:

<Steps>
  <Step>
    Back up first [#back-up-first]

    Go to **Backups** and save your current state. Mod incompatibilities can break worlds.
  </Step>

  <Step>
    Update the server [#update-the-server]

    Reinstall via **Dashboard** > **Reinstall Server**. See [Update Server](/docs/valheim/update-guide).
  </Step>

  <Step>
    Check mod compatibility [#check-mod-compatibility]

    Open **Mods** > **Installed Mods**. Some mods may show update buttons; others may need waiting for the author to release a fix.
  </Step>

  <Step>
    Update what you can [#update-what-you-can]

    Click **Update** on every mod that has a newer version available.
  </Step>

  <Step>
    Disable broken mods [#disable-broken-mods]

    If a mod hasn't been updated yet for the new Valheim version, **uninstall it temporarily** until the author releases a compatible version. Running incompatible mods can corrupt worlds.
  </Step>
</Steps>

> **Warning:** Running outdated mods after a game update can corrupt your world. Always back up before updating.

Notify Players About Updates [#notify-players-about-updates]

After updating mods, tell your players:

* **Which mods were updated** — so they can update their client copies
* **Any new mods added** — they need to subscribe and install
* **Any removed mods** — so they can clean up their client mod manager
* **Configuration changes** — if you tweaked any mod configs

> **Tip:** Recommend players use [r2modman](https://thunderstore.io/c/valheim/p/ebkr/r2modman/) to manage their client-side mods. It can sync from a profile code so everyone runs the same mod set.

Related Guides [#related-guides]

* [Install Mods](/docs/valheim/mod-setup)
* [Install ValheimPlus](/docs/valheim/install-valheimplus)
* [Update Server](/docs/valheim/update-guide)
* [Recommended Mods](/docs/valheim/recommended-mods)