How to host a Vintage Story dedicated server
Tutorials

How to Host a Vintage Story Server (Windows, Linux or Rented)

Run the dedicated server that ships with the game on Windows or Linux, size it, open the port and get past the 1.20 whitelist, or rent one that is up in a minute.

Want your own server? Vintage Story server hosting — plans, specs and regions.

November 16, 20267 min read
Share

On This Page

A Vintage Story dedicated server keeps your world running when nobody is logged in: crops grow, seasons change and the friend in another time zone can play when it suits them. Vintage Story isn't on Steam, so there's no SteamCMD step. The server comes from the developer and ships with the game. This guide covers hosting one on Windows, on Linux, and on a rented server, plus the 1.20 setting that stops your friends getting in.

What a Vintage Story server needs

The game's wiki gives a rough, conservative sizing guide for a normal survival world:

Recommended
Memory1 GB, plus 300 MB per player
CPU4 threads
NetworkPort 42420, TCP and UDP
Game versionThe same as every player's

Mods add to the memory figure. On our test server (game version 1.22.7), a fresh vanilla world idled at about 1.2 GB. With 16 popular mods installed (Primitive Survival, Butchering, Better Ruins and the like) it idled at about 2.1 GB, before anyone joined.

The step up from the official server

The official Vintage Story server software from the developer, installed and running about a minute after you pay, with your worlds, mods and settings as ordinary files under data/. Backups, file manager and SFTP on every plan.

Start a Vintage Story server

Option 1: Host on Windows

The server is already on your PC if the game is.

  1. Find VintagestoryServer.exe in the game's install folder and run it. A console window opens and the server creates its settings file, serverconfig.json, and a Saves folder in its data folder.
  2. Make yourself an admin. In the console, type /op YourName, using your account name exactly as it appears at the bottom left of the game's main menu.
  3. Let your friends in (see "The 1.20 whitelist" below).
  4. Forward port 42420 on your router for TCP, then again for UDP (needed since 1.20). Or try /serverconfig upnp 1 and let the server ask your router to do it.
  5. Share your public IP. Friends add it under Multiplayer → Add new server.

The server runs for as long as that window is open and that PC is on.

Option 2: Host on Linux

On Linux the server is a separate download, the "server only" archive vs_server_linux-x64_<version>.tar.gz from the developer's site.

  1. Install the .NET runtime. Game version 1.22 needs .NET 10 (1.21 needed .NET 8). The wrong version is the most common reason a Linux server won't start.
  2. Extract the archive into its own folder, such as server, and make server.sh executable.
  3. Install screen and pgrep, which the start script uses to run the server in the background.
  4. Start it: ./server.sh start.
  5. Run commands through the script, for example ./server.sh command "/op YourName".
  6. Open port 42420 in the firewall for TCP and UDP.

Settings changed by hand in serverconfig.json take effect at the next start. Commands typed into the console, such as whitelisting a player, take effect straight away.

The 1.20 whitelist: why nobody can join

This catches almost every new owner. Since 1.20, a new dedicated server is invite-only. At start-up the server says so itself: servers "no longer register themselves to the public servers list and are invite-only (whitelisted) out of the box". You send the address, and every friend is turned away.

Choose one before you invite anyone:

  • Let anyone with the address join: /serverconfig WhitelistMode off, and set a password with /serverconfig password yourpassword (no spaces).
  • Only named players: keep the whitelist and add each friend with /player FriendName whitelist on. No restart needed.

How to make a private Vintage Story server covers both in more detail.

Option 3: Rent a server

Home hosting is free, but the PC has to stay on, updates are yours to run, and your home IP is the address you give out. A rented server runs somewhere else, all the time.

The official server from the game's own store takes up to 8 players, or 16 with an upgrade. Its store page states the limits: it "does not support 3rd party mods", "the servers are located in Central Europe only", and "there is currently no process in place to allow for uploading of worlds".

Vintage Story server hosting at Connect runs the developer's own Linux server and does the setup above for you:

  • Running in about a minute. On our test server the install took under 40 seconds and the world was up about 30 seconds after start.
  • No whitelist step. New servers start with the whitelist off. The Server Settings tab turns the password, whitelist and public listing on and off without editing JSON.
  • Mods from the Mod DB in one click. The Mods tab picks the release for your game version and installs the mods it depends on. The game's own /moddb install command currently errors on 1.22.7, so this saves the manual route.
  • Your world. Upload a .vcdbs save from single player or another server and pick it as the active world.
  • A region near your players. Frankfurt, Helsinki, London, Virginia, Dallas, Montreal or Sydney. The game's troubleshooting guide warns of latency when players "connect from a different continent to where the server is hosted".
  • Updates by reinstall. Reinstall installs the newest stable version and keeps everything under data/: worlds, mods and settings.
  • Backups, a file manager and SFTP.

Plans take up to 8 (Hamlet, 4 GB), 16 (Village, 6 GB) or 24 players (Town, 10 GB). You can change plan later and keep your world.

Once it's running

  • Check the console for Dedicated Server now running. Until that line appears, players can't log in.
  • Match versions. Every player needs the server's version. New Connect servers install the latest stable release, currently 1.22.7.
  • Take a backup before mods, updates or a world swap.
  • Add mods with our modded server guide, and pick them from the best mods for a multiplayer server.

If friends still can't connect, players can't join goes through every cause in order.

Frequently Asked Questions

How do I host a Vintage Story server?

Run VintagestoryServer.exe from the game's folder on Windows, or the "server only" Linux download with .NET 10. Forward port 42420 (TCP and UDP), turn the whitelist off or add your friends, and share your IP. Or rent a server and skip the router and whitelist steps.

Is a Vintage Story server free?

The server software is free and comes with the game, so hosting it on your own PC costs nothing beyond electricity. Rented servers, official or third-party, are paid monthly.

What port does a Vintage Story server use?

42420 by default, over TCP and, since 1.20, UDP too. A rented server may use a different port. Give friends the address as IP:port.

How much RAM does a Vintage Story server need?

The game's wiki suggests 1 GB plus 300 MB per player. Mods add more: our test server idled at about 1.2 GB vanilla and 2.1 GB with 16 popular mods.

Why can't anyone join my new Vintage Story server?

Since 1.20, new dedicated servers are whitelisted by default. Run /serverconfig WhitelistMode off, or add each player with /player Name whitelist on.

Can I host a Vintage Story server on the same PC I play on?

Yes, if it has the memory for both. Or skip the separate server: open your single-player world to the internet from the Esc menu, which only works while you're playing. How to play Vintage Story with friends compares every option.

The step up from the official server

The official Vintage Story server software from the developer, installed and running about a minute after you pay, with your worlds, mods and settings as ordinary files under data/. Backups, file manager and SFTP on every plan.

Start a Vintage Story server

Or see plans, specs and regions on Vintage Story server hosting.

Related Help Articles

Need step-by-step instructions? Check out these guides in our Help Center.