merevge/vintagestory-server repository overview

⁠Vintage Story Server

A Docker image for a Vintage Story⁠ dedicated server. The server and mods are downloaded at startup, so the image stays version-agnostic.

• Pulls the latest server version on start, or a pinned one (VS_VERSION).
• Auto-downloads mods and their dependencies from the official ModDB⁠.
• Configures common serverconfig.json values from environment variables.
• Caches the server under /data, so restarts don't re-download it.
• One image variant per .NET version to cover different VS versions.

⁠Supported tags

Also published on GHCR as ghcr.io/merevge/vintagestory-server.

⁠Quick start

services:
  vintagestory:
    image: merevge/vintagestory-server:latest
    container_name: vintagestory-server
    restart: unless-stopped
    stop_grace_period: 60s
    stdin_open: true
    tty: true
    ports:
      - "42420:42420/tcp"
      - "42420:42420/udp"
    volumes:
      - ./data:/data
    environment:
      VS_SERVER_NAME: "My Server"
      VS_MODS: |
        carryon

docker compose up -d
docker compose logs -f

Everything the server writes — binaries, mods, world saves, config — lives under the single /data volume, so backing up the server is backing up that folder.

⁠Common configuration

A config token from the VS-Config-Generator⁠ can configure world generation, server settings and roles in one go via VS_CONFIG_TOKEN.

⁠Documentation and source

Full configuration reference, mod handling and troubleshooting: https://github.com/MErevGe/VintageStory-Server⁠

⁠License

MIT. Unofficial project — Vintage Story is © Anego Studios⁠; the game is downloaded at runtime and is not included in the image.