Vintage Story logo

How to Change Your Vintage Story Server Version

Learn how to change your Vintage Story server version or switch to different release branches

By the GhostCap teamUpdated

Changing your Vintage Story server version or switching between release branches allows you to access older versions or test upcoming features. This guide covers everything you need to know about managing your server version.

Whether you're rolling back to a previous version or experimenting with pre-release builds, follow this guide to safely manage your server version.

Danger

Always back up your world save before changing versions! Experimental and pre-release versions are intended for testing purposes only. GhostCap officially supports the stable release branch. Using unstable or experimental branches may result in unexpected behavior or compatibility issues.

Change Release Branch

  1. Access the GhostCap Panel and Stop your Vintage Story server.
  2. Open Settings.
  3. Find the Release branch setting.
  4. Select your desired branch:
    • stable - The latest stable release
    • unstable - Pre-release builds
    • pre - Experimental builds
  5. Click Save only to save without restarting your server.
  6. Click Reinstall in the top-right, choose Verify integrity, then click Verify + reinstall. For a clean installation, choose Format (keep settings) instead, which deletes all of your server's files, so create a backup first.

Change Specific Version

A community-maintained list of Vintage Story versions can be found here. Set Release branch to either stable or unstable depending on which branch the version you want belongs to.

  1. Access the GhostCap Panel and select your Vintage Story server.
  2. Open Settings.
  3. Find the Release version setting.
  4. Change the value from latest to your desired version number (e.g., 1.18.15).
  5. Find the Release branch setting and make sure it is set to stable or unstable, matching the branch your chosen version was released on.
  6. Click Save only to save without restarting your server.
  7. Click Reinstall in the top-right, choose Verify integrity, then click Verify + reinstall. For a clean installation, choose Format (keep settings) instead, which deletes all of your server's files, so create a backup first.
Caution

The version you enter must actually exist on the selected Release branch. If it doesn't, the reinstall will fail or the server will not start. Check the version list above to confirm which branch your version belongs to.

Note

When changing branches only, keep Release version set to latest. When pinning a specific version, Release branch can be stable or unstable, but it must match the branch that version was released on.