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.
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
- Access the GhostCap Panel and
Stopyour Vintage Story server. - In the sidebar, navigate to
Server Options. - Find the
Release branchsetting. - Select your desired branch:
stable- The latest stable releaseunstable- Pre-release buildspre- Experimental builds
- In the sidebar, go to
Advanced>Server Actionsand clickReinstall Server. In theReinstall Server?window, enableBackup Before Reinstalland, for a clean installation, optionally enableWipe All Files, then clickYes, Reinstall Server.
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.
- Access the GhostCap Panel and select your Vintage Story server.
- In the sidebar, navigate to
Server Options. - Find the
Release versionsetting. - Change the value from
latestto your desired version number (e.g.,1.18.15). - Find the
Release branchsetting and make sure it is set tostableorunstable, matching the branch your chosen version was released on. - In the sidebar, go to
Advanced>Server Actionsand clickReinstall Server. In theReinstall Server?window, enableBackup Before Reinstalland, for a clean installation, optionally enableWipe All Files, then clickYes, Reinstall Server.
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.
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.
