How to Update Mods on your Vintage Story Server

Update mods on your Vintage Story server by replacing the old mod file with a newer version. Because most mods change their .zip filename between releases, the old file won’t be overwritten automatically - you’ll need to remove it first.

There are two ways to do this: uploading the new file manually over SFTP, or letting the server fetch it with the /moddb install command. Both approaches take about the same amount of effort; pick whichever fits your workflow.

Method 1: Manual Upload via SFTP

Use this method if you prefer to manage files directly or if you’re updating several mods at once.

1. Head to mods.vintagestory.at, find the mod you want to update, and download the latest .zip release to your computer.
2. In the Game Control Panel, stop the server and wait for it to fully shut down before continuing.
3. Connect to your server via SFTP and navigate to the data/Mods folder.
4. Delete the existing .zip file for that mod.
5. Upload the new .zip you downloaded in step 1.
6. Start your server.

Method 2: /moddb install Command

Use this method if you’d rather not handle files directly. The server will download the latest version from the Vintage Story Mod Database for you.

Before running the command, you’ll need the mod’s ID. You can find it on the mod’s page at mods.vintagestory.at - it’s the short identifier in the URL, not the display name. Mod IDs are more reliable than names since names can contain spaces or special characters.

1. Stop your server and wait for it to fully shut down.
2. In the Game Control Panel, open the file manager and navigate to data/Mods.
3. Delete the existing .zip file for the mod you’re updating.
4. Start your server, then run the following command from the server console in your control panel or from in-game if you have operator access:

   /moddb install [modid]

Replace [modid] with the mod’s actual ID from the Mod Database. 5. Once the download completes, restart your server for the new version to load.