# How to Update Your The Isle Evrima Server (/docs/the-isle-evrima/update-guide)



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

The Isle Evrima receives updates regularly. Players auto-update through Steam when they're on the Evrima branch, so your server needs to stay current to avoid version mismatch.

<Steps>
  <Step>
    Create a backup [#create-a-backup]

    In the [XGamingServer Panel](https://panel.xgamingserver.com), go to **Backups** and create a backup. Major Evrima updates can occasionally affect save data.

    {/* Screenshot needed: Backups page */}
  </Step>

  <Step>
    Stop the server [#stop-the-server]

    Go to **Console** and stop the server.
  </Step>

  <Step>
    Reinstall [#reinstall]

    On the **Dashboard**, click **Reinstall Server**. This pulls the latest server files from the Evrima beta branch (`app_update 412680 -beta evrima`).

    {/* Screenshot needed: Dashboard with Reinstall Server widget */}
  </Step>

  <Step>
    Start the server [#start-the-server]

    Start from **Console** and watch for the version in the startup log.
  </Step>
</Steps>

Version Compatibility [#version-compatibility]

* **Server version must match client version** — both need to be on the same Evrima patch
* **Branch must match** — players on the Legacy branch cannot connect to Evrima servers
* **Forward compatibility** — saves typically work with newer versions, but not vice versa

After Updating [#after-updating]

| Check                         | Why                                                                                                |
| ----------------------------- | -------------------------------------------------------------------------------------------------- |
| **Server appears in browser** | Confirms the server registered with EOS after the update                                           |
| **Players can connect**       | Tests version match end-to-end                                                                     |
| **Game.ini still valid**      | Some updates add new settings — review the [config reference](/docs/the-isle-evrima/server-config) |

Common Issues [#common-issues]

| Problem                       | Fix                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------- |
| Version mismatch after update | Player's Steam may not have updated yet — restart Steam to force the update check |
| Server reverted to Legacy     | The reinstall must use `-beta evrima`. XGamingServer handles this automatically   |
| Save data won't load          | Restore from your backup. Wait for a hotfix if there's a save format change       |

Related Guides [#related-guides]

* [Server Configuration](/docs/the-isle-evrima/server-config)
* [Backup & Restore](/docs/the-isle-evrima/backup-restore)
* [Wipe & Reinstall](/docs/the-isle-evrima/wipe-reinstall)
