October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

Vintage Story Server Commands and Admin Setup Guide (2026)

A practical Vintage Story server guide covering separate data paths, Linux and Windows setup, port 42420, whitelist security, first-admin bootstrapping, roles, privileges, daily commands and version-specific troubleshooting.
Length10 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set up a Vintage Story dedicated server in its own data directory, secure it before sharing the address, and grant administration through roles rather than handing every moderator full control. On Linux, run the server under a dedicated non-root account; on Windows, launch the server with a separate --dataPath. Use the console for the first /op assignment, then verify every command against /help and the in-game Command Handbook because the public command list is only verified through version 1.15.

The safe setup sequence

A reliable installation follows this order:

  1. Create a separate server data directory. Keep multiplayer worlds, serverconfig.json, logs and server-specific settings out of your single-player data folder.
  2. Install the server files and start the process once so it creates its initial configuration.
  3. Secure the instance before inviting anyone: enable the whitelist, set a password if appropriate, and hide the public listing when the server is private.
  4. Use the server console or startup script to run /op <username> for the first administrator. A normal new player has the suplayer role and cannot grant privileges.
  5. Create limited moderator roles with only the privileges they need. Check the privileges actually installed on your build and by your mods.
  6. Use /help and the in-game Command Handbook (.chb) whenever a command behaves differently from an example below.

Text in angle brackets is a placeholder. Type the value without the brackets; for example, type /op Alex, not /op <username>.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Plan the server’s files and account first

Why a separate data path matters

The server stores worlds and configuration in its data path. A dedicated path prevents a multiplayer save from being mixed with single-player saves and makes backups, migrations and permissions easier to manage. The official dedicated-server guide uses a directory such as VSserverData for this purpose and places serverconfig.json inside that directory.

Do not treat the executable’s directory as the data directory by accident. Decide where the data should live before the first long-running world is created, then pass that location explicitly at launch.

#1 Best Overall
What's Your Story? Memory Sharing Game
  • ENTERTAINING AND UNEXPECTED QUESTIONS: This handy box is filled with 140 surprising and engaging prompts to inspire reminiscences between family, friends, or couples!
  • FAMILY GAME NIGHT FUN: A special way to inspire intergenerational sharing. Great family game for kids and adults.
  • TAKE IT ANYWHERE: The portable box is the ideal size to throw in your bag to take on vacation or to a family get-together.
  • A FUN GIFT: Perfect for game night enthusiasts; kids, parents, and grandparents wanting to connect across the generations; anyone in search of birthday presents, anniversary gifts, or stocking stuffers for adults, teens, or the whole family.
  • EXPLORE THE ENTIRE SERIES: This game is part of the Games Room series, a collection of elegantly designed, geometrically patterned small boxes filled with engaging games to inspire lively conversation and endless laughs.

Windows or same-machine hosting

For a Windows host, create a folder such as VSserverData outside the single-player save location. Launch the server executable with a data-path argument:

VintageStoryServer.exe --dataPath="C:PathToVSserverData"

Use your real path in place of the example. After the first launch, confirm that serverconfig.json appears in the specified directory. Keep that directory in your backup plan; copying only the executable does not copy your worlds or settings.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Linux: use a dedicated, non-root account

The dedicated-server guide strongly recommends never running the server as root. Create a separate account named, for example, vintagestory, and give it ownership of the server and data directories. This limits the damage a compromised mod, script or server process could cause elsewhere on the machine.

The current runtime requirement depends on the Vintage Story version:

Vintage Story version Required .NET runtime in the guide
1.22.0 and newer .NET 10
1.21.0 and newer, but before 1.22.0 .NET 8
Versions older than 1.21.0 .NET 7

Install the runtime that matches the release you are actually running; do not assume that the newest runtime is valid for every older server build.

Download and lay out the Linux files

  1. Download the Linux tar.gz Archive (server only) for your Vintage Story version.
  2. As the vintagestory user, extract the archive into /home/vintagestory/server.
  3. Create /home/vintagestory/data for worlds and configuration.
  4. Make the launcher executable:
chmod +x /home/vintagestory/server/server.sh

The guide’s launcher variables are:

USERNAME=vintagestory
VSPATH=/home/vintagestory/server
DATAPATH=/home/vintagestory/data

Set those values in the launcher’s configuration as directed by the release package. Keeping VSPATH and DATAPATH separate makes it possible to replace server binaries without disturbing worlds.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Start the Linux service and open the network port

Firewall and router requirements

When a host firewall is enabled, allow port 42420 for both TCP and UDP. If players connect from outside your home network, the router must also forward that port to the server machine. A firewall rule that permits only TCP can produce confusing partial connectivity, so configure both protocols.

Rank #2
Disney Pixar Toy Story Cooperative Deck-Building Game | Family Board Game Featuring Characters and Artwork from Toy Story Movies and Short Films | Officially Licensed Disney Pixar Merchandise
  • HOWDY PARTNER - Welcome to Disney Pixar Toy Story Obstacles & Adventures, the cooperative deck-building game that brings the world of Toy Story to life! Play as your favorite characters from the films - Sheriff Woody, Buzz Lightyear, Jesse, Rex and Bo Peep
  • TO INFINITY, AND BEYOND - This family board game features artwork, characters, obstacles, and adventures from across all the Toy Story movies and television films - Toy Story, Toy Story 2, Toy Story 3, Toy Story 4, Toy Story of Terror!, and Toy Story That Time Forgot
  • THERE'S A SNAKE IN MY BOOT - Watch out for the hazards and obstacles that try and end playtime, While the toys may be cute, don't let them deceive you as there are serious challenges along the way
  • YOU'VE GOT A FRIEND IN ME - Work together in this cooperative group game as you build your deck and move along the 6 sequential games that build on their level of difficulty
  • 2-5 players | Ages 8+ | 30-90+ Min Play Time

Launcher commands

The supplied server.sh script supports these operations:

Command Purpose
start Start the server.
stop Stop it cleanly.
status Check whether it is running.
update Run the package’s update workflow.
restart Stop and start the service.
setup Run the launcher setup routine.
command Send a server command without opening an interactive console.

Start it with:

/home/vintagestory/server/server.sh start

To bootstrap an account from a shell, the guide shows:

/home/vintagestory/server/server.sh command "/whitelist add Alex"
/home/vintagestory/server/server.sh command "/op Alex"

Replace Alex with the player name. The first line uses the launcher’s whitelist command syntax; once connected in game, the player command form documented for current servers is /player Alex whitelist on. If one form is rejected, run /help on that build rather than guessing a renamed subcommand.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Secure the server before inviting players

Whitelist behavior and private listings

Dedicated servers use whitelist mode by default from Vintage Story 1.20. Older instructions that tell you to set OnlyWhitelisted are obsolete for that configuration model. The current setting is WhitelistMode, with default, off and on values.

To add a player while operating in game or in an authorized console, use:

/player <username> whitelist on

To remove that player from the whitelist:

/player <username> whitelist off

You can make the server less discoverable and require a password through the server configuration commands:

/serverconfig advertise false
/serverconfig password <password>
/serverconfig WhitelistMode on

The documented password form contains no spaces. Use a strong, unique password and share it only through a channel you trust. advertise false hides the listing; it does not replace a whitelist or password.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
It’s Kind of a Fun Story – Adult Party Game & Storytelling Card Game with 320 Conversation Cards for Friends, Couples, Families, Game Nights, Bachelorette Parties, Pre-Games, and Happy Hours
  • A WHOLE NEW WAY TO PARTY: Skip the small talk and spark unforgettable conversations with It’s Kind of a Fun Story, the adult party game where the story of your life earns you points. Perfect for adult game nights, pre-games, happy hours, bachelorette parties, or family gatherings.
  • EASY TO LEARN, FUN TO PLAY: Take turns drawing cards and answering questions to be the first player to earn seven points! Story Cards put you in the spotlight to tell a story from your life, but watch out, if another player thinks they have a better tale, they can play a Hear Me Out Card to try to steal your points. Left or Right, Point a Finger, and Everybody Answers cards keep every round fresh, fast-paced, and full of surprises.
  • FUN, HEARTFELT, AND FULL OF CONNECTION: With 320 conversation cards, every round is unique, hilarious, and full of exciting stories. More than just a funny adult card game, it brings people closer: laugh together, share embarrassing memories, and bond over stories that are silly, surprising, or even deep.
  • CUSTOMIZE YOUR VIBE: Keep it clean or make it spicy with the included R-Rated mini-expansion pack. Clearly marked R-Rated cards let you adjust to your group, and every player gets a Nope Card to skip any topic they’re not comfortable with. Everyone stays engaged and having fun. Perfect as a drinking game, icebreaker game, or casual conversation game.
  • PERFECT FOR EVERY OCCASION: Ideal for friends’ game nights, family gatherings, pre-games, happy hours, bachelorette parties, or adult game nights. It’s Kind of a Fun Story is the ultimate adult storytelling card game that gets everyone laughing, sharing, and connecting every time you play.

Configuration-file changes require a relaunch

The guide states that changes written to serverconfig.json do not take effect until the server is relaunched. Before stopping, save the world with:

/autosavenow

Then stop and relaunch:

/stop

Use the appropriate Windows executable or Linux launcher to start it again. Individual whitelist and role commands generally apply without a full restart, but a file edit such as changing DefaultRoleCode requires the relaunch sequence.

Bootstrap the first administrator

Why the console is often required

A newly connected player normally receives the suplayer role. That role is intentionally unable to manage privileges, so a player cannot reliably promote themselves from chat. Run the first elevation from the server console, a startup script, or another already-authorized administrator:

/op <username>

The command assigns the administrative role in the command reference. Confirm the result by reconnecting or checking the player’s role with the available /player information commands. If /op is unavailable in your build, consult /help; command names can be changed by version or mods.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Remove full administration when it is no longer needed

The corresponding shortcut in the command reference is:

/deop <username>

For a moderator who only needs a few capabilities, remove the administrative role and use a restricted role instead of leaving permanent full access.

Roles and privileges: give moderators only what they need

Inspect what this installation supports

Privilege names and availability can vary between server versions and installed mods. Start with:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Prey - PC
  • In Prey, you awaken aboard Talos I, a space station orbiting the moon in the year 2032.
  • You are the key subject of an experiment meant to alter humanity forever - but things have gone terribly wrong.
  • The space station has been overrun by hostile aliens and you are now being hunted.
/list privileges

Common names listed in the command reference include build, use, chat, attack, controlserver, gamemode, time, teleport and grantrevoke. Treat that list as examples, not a guarantee that every name exists on your server.

Grant a privilege to one player

Use the player-level form when the permission should apply to one person:

/player <username> privilege grant <privilege>
/player <username> privilege revoke <privilege>

For example, a support moderator might receive chat and teleport but not controlserver or grantrevoke. The exact combination should follow the duties you have assigned, not a copied “moderator” recipe.

Create or adjust a role

Role-level grants apply to everyone assigned that role:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
/role <rolecode> privilege grant <privilege>
/role <rolecode> privilege revoke <privilege>

Assign a role to a player with:

/player <username> role <rolecode>

Keep a written record of why each privilege is present. In particular, grantrevoke and controlserver can expand a moderator’s ability far beyond routine chat or player support.

Use a restricted visitor role when appropriate

To make newly joining players visitors who can look around and chat but cannot use, place or break anything, set:

DefaultRoleCode=suvisitor

The guide does not currently document a command for changing this default role code. Edit serverconfig.json in the server data path, save it, run /autosavenow, stop the server and relaunch it. For an individual player, the documented command is:

Best Value
3 PCS Metal Brain Teaser Puzzles Set for Present Gift
  • 3-Piece Premium Metal Puzzle Set for Adults 15+: This curated bundle has 3 unique vintage metal disentanglement puzzles for teens and adults craving brain challenges. Precision-cast high-strength alloy brings solid weight and smooth burr-free edges, no cheap plastic parts at all.
  • Durable Anti-Rust Build for Long-Term Play & Collection:Premium electroplated vintage metal coating resists scratches, fading and rust after months of repeated twisting. The sturdy structure won’t bend or break easily, making it a long-lasting collection piece for countless play sessions.
  • Boost Spatial Logic & Focus in a Screen-Free Way:This 3D IQ game trains your patience, spatial imagination and reverse thinking as you twist and explore hidden mechanisms. Gradual difficulty keeps you engaged for hours, melting work stress and keeping your mind sharp.
  • Pocket-Sized Fun for Travel, Parties & Gatherings:Compact and lightweight enough to slip into your bag or jeans pocket, it lets you enjoy brain teasers on commutes, trips or family game nights. It livens up group interactions and pulls everyone away from mindless scrolling.
  • Thoughtful Gift for Puzzle Lovers & Special Occasions:With clear illustrated instructions, this challenging disentanglement set is perfect for birthdays, anniversaries and holiday gifting. It’s more than a game — a fun, memorable way to share quality time with friends and partners.
/player <username> role suplayer

Choose the role deliberately: changing a player to suplayer gives the normal player role, while changing the default in the file affects future joins.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Essential commands for daily administration

The following commands cover the common operations. Run /help on the running server if a subcommand or argument differs.

Task Command Notes
Show available commands /help Use this as the authority for the installed build.
List connected clients /list clients Useful before a restart or incident.
List banned players /list banned Review and audit bans.
List players by role /list role Check who has elevated access.
List installed privileges /list privileges Names can change with versions and mods.
Remove a player temporarily /kick <name> [reason] Reason is optional; do not type the square brackets.
Ban a player /ban <name> [reason] Use a clear reason for later review.
Lift a ban /unban <name> Then handle whitelist status separately if needed.
Send a server-wide message /announce <message> Useful for maintenance notices.
Save immediately /autosavenow Run before planned shutdowns or file edits.
Stop cleanly /stop Use the launcher to start again.
Change player limit /serverconfig maxclients <number> Restart if the change is not applied live on your build.
Set or change password /serverconfig password <password> The documented password has no spaces.
Show or hide listing /serverconfig advertise <true|false> Hiding the listing is not a replacement for access control.
Set whitelist mode /serverconfig WhitelistMode <default|off|on> Use the current key; OnlyWhitelisted is obsolete from 1.20.

Why a command may fail

The syntax changed

The public command page says its long list was last verified for version 1.15. It is useful for discovering concepts, but it is not a version-neutral contract. The in-game Command Handbook (.chb) and the running server’s /help output reflect your installed build. Mods can add commands or alter available arguments.

You typed explanatory brackets

Square and angle brackets in documentation indicate optional arguments or placeholders. They are not literal characters. Use /kick Alex griefing, not /kick <Alex> [griefing].

You are using the wrong execution context

A player with suplayer cannot grant privileges. Run the first /op from the server console or Linux launcher, then reconnect with the elevated account. If a command works in the console but not in chat, verify the player’s role and privilege rather than repeating the command.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The configuration file appears unchanged

Check that you edited the serverconfig.json inside the active data path, not a similarly named file beside the executable. Save the world, stop the process and relaunch; file edits are not live until restart.

The server is unreachable

  • Confirm the process is running with server.sh status on Linux.
  • Check that port 42420 is allowed for both TCP and UDP.
  • Verify router forwarding points to the correct host if players connect from the internet.
  • Confirm that the server is not hidden intentionally with advertise false.
  • Check whitelist mode and the player’s whitelist state before changing network settings.

Self-hosting or managed hosting?

Self-hosting gives you direct control over the operating system, firewall, console, serverconfig.json, update timing and mod files. It also makes you responsible for patching the runtime, backups, port forwarding, monitoring and recovery. A managed provider may simplify those operations, but the practical questions remain the same: can you access the console and configuration, how are backups restored, how are mods and updates handled, what player capacity is included, where is the machine located, and what support is available? Compare those items and the total monthly cost for your expected player count; the setup instructions above establish the self-hosting work but do not establish provider prices or performance.

Quick Recap

Bestseller No. 4
Prey - PC
Prey - PC
In Prey, you awaken aboard Talos I, a space station orbiting the moon in the year 2032.; The space station has been overrun by hostile aliens and you are now being hunted.
$7.99

Maintenance checklist

  • Keep the server under a dedicated non-root Linux account.
  • Back up the entire data directory, including worlds and serverconfig.json, before updates or major configuration changes.
  • Run /list role and review elevated accounts periodically.
  • Use /list privileges after adding or updating mods.
  • Save with /autosavenow before every planned stop.
  • After an update, test /help, whitelist operations, role assignment and any moderator-specific commands before inviting players back.
  • Document the installed Vintage Story version and required .NET runtime so a future administrator does not start the server with the wrong dependency.

Version boundaries to remember

  • The dedicated-server guide was revised in January 2026.
  • Whitelist defaults and the obsolete OnlyWhitelisted setting changed at the 1.20 boundary.
  • Linux runtime guidance is .NET 10 for 1.22.0 and newer, .NET 8 for 1.21.0 and newer before 1.22.0, and .NET 7 for earlier releases.
  • The broad public command list was last verified for 1.15, so use the running server’s help and handbook for authoritative syntax.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.