DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
VGSources
Blog

Vintage Story Server Start Options and Launch Arguments

A complete reference for Vintage Story dedicated-server launch arguments, including platform commands, data isolation, ports, capacity, configuration scope, Linux lifecycle options and troubleshooting.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Start a dedicated Vintage Story server by running the installed server program with the options that match your environment. On Windows, that is typically VintageStoryServer.exe; on Linux you can run the .NET assembly with dotnet VintagestoryServer.dll or use the native VintagestoryServer binary. Put server files in a separate --dataPath, then use --ip, --port, --maxclients, --logPath, and the configuration flags as needed. Run the binary’s own --help and --version first: the installed build is authoritative, and the documented startup page is verified for Vintage Story 1.19.8.

Start with the installed build’s help output

Vintage Story’s startup parameters can change between releases. The Wiki’s startup-parameter reference explicitly advises opening the game directory and running VintageStoryServer.exe --help to list the arguments implemented by that particular build. Use the equivalent command for your Linux executable. Check the version at the same time with --version; the multiplayer setup documentation is verified for 1.20.0, while the startup-parameter page is verified for 1.19.8.

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.
VintageStoryServer.exe --version
VintageStoryServer.exe --help

These commands print information and exit. They are the safest way to catch renamed or newly added switches before putting a command into a service, container, or hosting panel.

Minimal commands for each platform

Windows executable

From the directory containing the dedicated-server executable, a practical command is:

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.
VintageStoryServer.exe --dataPath "C:VSDataMyServer" --port 42420 --maxclients 16

The Windows line combines documented options as an example. Confirm the exact spelling and availability with that installation’s --help output. Quoting the path protects spaces and keeps the server’s saves, configuration, and logs in a deliberate location.

Linux with .NET

The documented .NET form is:

dotnet VintagestoryServer.dll --dataPath /srv/vintagestory/data

This requires the runtime expected by the installed server package. Add network or capacity switches after the data path when your deployment needs them.

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

Linux native binary

If your package includes the native executable, launch it directly:

./VintagestoryServer --dataPath /srv/vintagestory/data

Make the file executable and run it from the installation directory, or provide an absolute path. In every form, --dataPath is the important isolation setting when the game client and server share a computer.

What launch arguments control

Startup flags configure the process and its file locations, networking, capacity, and launch-time configuration. The following inventory reflects the documented options; defaults are the values listed by the startup reference, not a performance guarantee.

Option Purpose Documented value or behavior
-v, --version Print the game version and exit. No server remains running.
-h, --help Print implemented startup parameters and exit. Use this output for the installed build.
-s, --standby Wait for the first connection attempt before fully launching. Useful when you do not want complete startup work until a client connects.
--genconfig Create a fresh default serverconfig.json and exit. Warns that an existing configuration will be deleted.
--setconfig Set persistent configuration values and create serverconfig.json if it does not exist. Uses a JSON-like argument, for example --setconfig="{ key: 3, foo:'value' }".
--withconfig Override configuration values for one launch. Uses the same JSON-like style; it is not the same as writing persistent values.
--dataPath Choose the server data directory. A custom path is recommended to separate dedicated-server data from single-player data.
--logPath Choose the log directory. The reference specifies an absolute log path.
--addOrigin Load additional assets from a path. Supply the path required by the installation.
--addModPath Load mods from one or more additional paths. Keep mod directories explicit so maintenance scripts know where content comes from.
--ip Bind the server to a particular IP address. Overrides the configured address.
--port Choose the listening port. The documented default is 42420; a command-line value overrides configuration.
--maxclients Set the maximum simultaneous clients. The documented default is 16.
--archiveLogFileCount Set how many log files are retained in the archive. The documented default is 5.
--archiveLogFileMaxSizeMb Set the maximum archive size. The documented default is 1024 MB.

The archive figures are configuration defaults documented for the startup page, not measured limits on how many players your hardware can support. CPU, memory, world size, mods, network quality, and tick workload still determine a comfortable player count.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Keep server data separate with --dataPath

The data path holds the dedicated server’s saves, configuration, and operational files. Without an explicit location, it is easy to mix a server world with the client profile or to let two processes read the same settings. Choose a directory owned by the account that runs the service, back it up, and use the same path in every launch method.

  • Windows example: C:VSDataMyServer.
  • Linux example: /srv/vintagestory/data.
  • For several worlds or instances, give each process a different data directory and port.

Changing --dataPath later makes the server appear empty because it is looking at a new directory. Stop the process, copy the existing data to the new location, check ownership and permissions, and then start with the new path.

Choose between --genconfig, --setconfig, and --withconfig

--genconfig: reset to a fresh file

Use --genconfig when you deliberately want a new default serverconfig.json. It exits after generation and warns that an existing configuration is deleted, so make a backup before running it. This is a reset tool, not a routine startup flag.

--setconfig: write persistent values

--setconfig changes or creates the configuration file. The reference shows JSON-like syntax:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
VintageStoryServer.exe --setconfig="{ key: 3, foo:'value' }"

Use the property names accepted by your build. Because this writes persistent configuration, review the generated file and record the command in your deployment notes.

--withconfig: apply a launch-only override

--withconfig supplies temporary values for the current launch. It is appropriate for a test instance, a maintenance run, or a service that injects environment-specific settings without rewriting the base file. A later launch without the override returns to the saved configuration.

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Decide what belongs in startup flags versus server configuration

Use launch arguments for process-level concerns: executable diagnostics, data and log locations, bind address, port, client capacity, extra asset or mod directories, and temporary configuration overrides. Use the runtime command or JSON file for gameplay and access policy.

Runtime commands with /serverconfig

The command reference includes examples such as:

/serverconfig maxclients <number>
/serverconfig password <password>
/serverconfig advertise <true|false>
/serverconfig WhitelistMode <default|off|on>
/serverconfig maxchunkradius <number>

These commands are convenient while the server is running. They cover settings such as password protection, advertising, whitelist mode, PvP, fire spread, entity spawning, tick rate, chunk radius, spawn point, and related world rules.

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

Editing serverconfig.json

For repeatable administration, stop the server before editing serverconfig.json. The dedicated-server guide advises relaunching after file changes so the process reads the new values. Keep a dated backup, preserve valid JSON syntax, and change one group of settings at a time so a startup error is easy to identify.

Dedicated servers use whitelisting by default as of version 1.20, according to the dedicated-server guide. If you are upgrading from an older installation, inspect the effective whitelist setting rather than assuming the previous behavior remains.

Network binding, port forwarding, and player capacity

Binding an address

--ip overrides the configured bind address. Bind to the interface that should accept connections; an incorrect address can make the process start while remaining unreachable from the intended network. If you need local testing only, use the address appropriate to that interface and verify it with the server’s startup output.

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.

Selecting a port

--port overrides the configured port, whose documented default is 42420. If you change it, update the firewall rule, router forwarding rule, and the address players use. Only one process can normally listen on a given IP-and-port combination, so separate instances require separate ports or addresses.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Limiting clients

--maxclients overrides the simultaneous-client limit; the startup reference lists 16 as the default. A higher number is a policy choice, not a guarantee that the machine can simulate that many players. Watch memory, tick stability, and log warnings after changing it.

Logs, assets, and mods

Set --logPath to an absolute directory when logs should live outside the data tree or on a separate disk. The archive controls prevent indefinite growth: the documented defaults retain five archived files and cap an archive at 1024 MB. Choose lower limits on a small disk and higher limits only when you have a retention plan.

--addOrigin adds an asset source, while --addModPath adds one or more mod directories. Keep custom content paths stable and readable by the service account. When a mod fails to load, first start without the extra path, then add paths back one at a time; this distinguishes a path or permission problem from an incompatible mod.

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

Keep the process running on Linux

The supplied server.sh wrapper

The Linux guide documents a lifecycle wrapper with commands including start, stop, status, update, restart, setup, and command. Use the wrapper when you want a documented script to own the process and provide consistent lifecycle actions. Confirm that its configured installation and data paths match the command you tested manually.

systemd

For a machine that should start the server at boot and restart it under a service policy, deploy it with systemd as described in the Linux guide. The unit should run under a dedicated account, use the intended working directory, include the tested executable and --dataPath, and write logs somewhere that the account can access. Test stop, start, status reporting, and a reboot before calling the deployment production-ready.

Direct process versus service manager

Method Best fit Operational trade-off
Direct executable Short tests or an administrator watching the console. Stops when the terminal or session ends unless separately detached.
server.sh Linux operators who want the documented start/stop/update commands. Adds wrapper configuration that must remain aligned with the installation.
systemd Persistent Linux hosting and boot-time startup. Requires unit-file, account, permission, and restart-policy setup.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Windows dedicated mode versus opening a world to LAN

The official self-hosting guidance distinguishes an ad-hoc world opened to LAN from a dedicated server. LAN sharing is tied to a running game session. A dedicated server remains available by launching VintageStoryServer.exe from the installation path, independent of a player keeping the client open. Use the dedicated executable when the world must stay online or be managed as a service.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

Managed hosting: what the provider is operating

A managed host is still operating the same layers: the Vintage Story server executable, a data directory, configuration files, network binding, logs, mods, and a lifecycle process. Before committing, verify that the provider exposes the arguments and files you need, supports your target Vintage Story version, allows backups and mod paths, and states how port changes, updates, restarts, and data export work. Do not assume a hosting panel supports every switch simply because the underlying executable does.

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

Troubleshooting launch failures

The command says an option is unknown

Run --help on the exact executable and remove flags that are not listed. Do not copy a command from a different release without checking it; the reference itself is version-specific.

The server starts with a new world

Compare the current --dataPath with the path used by the original instance. Stop the process, restore or copy the world into the intended directory, fix ownership, and restart with one consistent path.

Players cannot connect

  • Confirm the process is listening on the selected --ip and --port.
  • Allow that port through the host firewall and forward it on the router when connections originate from the internet.
  • Check that another server is not already using the same address and port.
  • Test locally first, then from the remote network, to separate binding problems from routing problems.

Configuration changes have no effect

Check whether a launch flag or --withconfig is overriding the file. For JSON edits, stop the server before editing and relaunch afterward. For a live change, use the corresponding /serverconfig command and verify the resulting value.

Logs fill the disk

Set an explicit --logPath, review the archive count and maximum size, and remove old archives only after preserving any records needed for diagnosis. The documented defaults are five archived files and 1024 MB per archive.

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

A repeatable deployment checklist

  1. Run --version and --help from the installed server directory.
  2. Create a dedicated data directory and choose an absolute log directory.
  3. Start once with --dataPath and verify that the expected configuration and world files appear there.
  4. Set the bind address, port, and client limit; open matching firewall and forwarding rules.
  5. Apply persistent behavior through /serverconfig or a stopped-server edit of serverconfig.json.
  6. Add asset and mod paths one at a time, checking startup logs after each change.
  7. Choose direct launch, server.sh, or systemd according to the required uptime.
  8. Back up the data directory and test a stop, restart, and restore procedure before inviting players.

Version and default caveats

The startup-parameter page is verified for Vintage Story 1.19.8, the multiplayer setup page for 1.20.0, and the dedicated-server guide notes the version-1.20 default of whitelisting. Defaults and accepted syntax can change. Treat the installed executable’s --help and --version output as the final authority whenever you upgrade, move the server, or adopt a hosting panel.

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.