Alpha Game Server Manager

Dedicated server guide

Vintage Story

Manage vintagestoryserver with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Recorded lifecycle pass · Support evidence: 2026-10-16.

Build setup commands
Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

42420/UDP, 42420/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Mods and plugins

No mod support is declared in this snapshot; review the game guide before adding mods.

Backup hook

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Choose a supported runtime

Linux and Docker quickstart

Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

  1. Start the Docker manager ./alphagsm-docker start
  2. Create the game instance ./alphagsm-docker my-vintagestoryserver create vintagestoryserver
  3. Complete interactive setup ./alphagsm-docker my-vintagestoryserver setup
  4. Start the game server ./alphagsm-docker my-vintagestoryserver start
  5. Check the instance status ./alphagsm-docker my-vintagestoryserver status
./alphagsm-docker start
./alphagsm-docker my-vintagestoryserver create vintagestoryserver
./alphagsm-docker my-vintagestoryserver setup
./alphagsm-docker my-vintagestoryserver start
./alphagsm-docker my-vintagestoryserver status

Host process

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

  1. Create the game instance ./alphagsm my-vintagestoryserver create vintagestoryserver
  2. Complete interactive setup ./alphagsm my-vintagestoryserver setup
  3. Check the host prerequisites ./alphagsm my-vintagestoryserver doctor
  4. Start the game server ./alphagsm my-vintagestoryserver start
  5. Check the instance status ./alphagsm my-vintagestoryserver status
./alphagsm my-vintagestoryserver create vintagestoryserver
./alphagsm my-vintagestoryserver setup
./alphagsm my-vintagestoryserver doctor
./alphagsm my-vintagestoryserver start
./alphagsm my-vintagestoryserver status

This guide covers the vintagestoryserver module in AlphaGSM.

vintagestoryserver is currently PASSED on the documented Ubuntu 24.04 Linux baseline. The checked-in GitHub validation path for this server is Docker-first through the shared steamcmd-linux runtime, with dotnet VintagestoryServer.dll --dataPath <install_dir> answering generic tcp query / info on the managed game port.

Requirements

  • screen
  • .NET 10 runtime on process-backed hosts
  • Docker runtime supported through the shared steamcmd-linux family image
  • Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myvintages create vintagestoryserver

Run setup:

alphagsm myvintages setup

Start it:

alphagsm myvintages start

Check it:

alphagsm myvintages status

Stop it:

alphagsm myvintages stop

Setup Details

Setup configures:

  • the game port (default 42420)
  • the install directory
  • resolves the latest stable Linux server archive by default
  • downloads and extracts the server archive
  • keeps the existing Docker-backed steamcmd-linux lane available for hosts without local dotnet

Useful Commands

alphagsm myvintages update
alphagsm myvintages backup

You can pin a specific server build or override the archive URL during setup:

alphagsm myvintages setup --version 1.22.2
alphagsm myvintages setup --url https://cdn.vintagestory.at/gamefiles/stable/vs_server_linux-x64_1.22.2.tar.gz

Notes

  • Module name: vintagestoryserver
  • Default port: 42420

Server variables

After create vintagestoryserver, inspect or change these with set:

alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE

This module does not declare schema-backed keys. set --list after create is still the live source of truth.

Developer Notes

Run File

  • Executable: VintagestoryServer.dll
  • Location: <install_dir>/VintagestoryServer.dll
  • Engine: .NET 10 / Vintage Story dedicated server

AlphaGSM follows the upstream server.sh launcher contract on Linux and starts the server with dotnet VintagestoryServer.dll --dataPath <install_dir>.

The validated Linux integration lane on release_v1 is the module's existing Docker-backed steamcmd-linux runtime. The checked-in integration and smoke paths now prefer a rebuilt local alphagsm-steamcmd-linux-runtime:test image when it is available, then fall back to ALPHAGSM_BACKEND_DOCKER_IMAGE_STEAMCMD_LINUX, then the published ghcr.io/sectoralpha/alphagsm-steamcmd-linux-runtime:latest image.

Server Configuration

Maps and Mods

  • Map directory: Check game documentation
  • Mod directory: Check game documentation
  • Workshop support: No

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

Share your server

Sector Alpha server directory

When your server is ready, you can publish its connection details and community information on Sector Alpha. Review your listing and keep the information current.

Find a community

Browse the directory for game servers and their published connection details.

Browse server directory

Publish your server

Prepare a name, address and description for your listing.

Publish a server

Manual server sharing instructions

Frequently asked questions

What support evidence is recorded for Vintage Story?

Recorded lifecycle pass. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Which runtimes can run Vintage Story?

Declared runtimes: Docker or a Linux host process.

Which ports does Vintage Story use?

42420/UDP, 42420/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Can I add mods to Vintage Story?

No mod support is declared in this snapshot; review the game guide before adding mods.

How should I back up Vintage Story?

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Source and support evidence

This guide mirrors AlphaGSM’s upstream documentation at 32cef5ba9e03053c8e461fffa0ba133b160b528d. Commands and prerequisites can change. Check current support notes before installation.

All game guides