Dedicated server guide

Barotrauma

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

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

Anonymous Workshop Process and Docker load passed for public dedicated-server content. Mod installation explains add, apply, and cleanup.

Build setup commands

Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

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

Mods and plugins

For Workshop content, use the setup builder with an actual game-compatible item ID; review supported content types in the guide. Anonymous Steam Workshop content for this module passed both process and Docker load. After setup, record an item with mod add workshop using a numeric ID or Steam Workshop URL, then run mod apply.

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.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-btserver create btserver
Complete interactive setup ./alphagsm-docker my-btserver setup
Start the game server ./alphagsm-docker my-btserver start
Check the instance status ./alphagsm-docker my-btserver status

./alphagsm-docker start
./alphagsm-docker my-btserver create btserver
./alphagsm-docker my-btserver setup
./alphagsm-docker my-btserver start
./alphagsm-docker my-btserver 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.

Create the game instance ./alphagsm my-btserver create btserver
Complete interactive setup ./alphagsm my-btserver setup
Check the host prerequisites ./alphagsm my-btserver doctor
Start the game server ./alphagsm my-btserver start
Check the instance status ./alphagsm my-btserver status

./alphagsm my-btserver create btserver
./alphagsm my-btserver setup
./alphagsm my-btserver doctor
./alphagsm my-btserver start
./alphagsm my-btserver status

This guide covers the btserver module in AlphaGSM.

btserver is currently PASSED in the checked-in support tracker. On the documented Ubuntu 24.04 Linux baseline, the current smoke and GitHub integration coverage runs through the shared steamcmd-linux Docker runtime, while local host-process flows remain the fallback path documented elsewhere in the repo. AlphaGSM checks Barotrauma through the live Lidgren UDP surface on the primary game port rather than assuming the adjacent Steam query port provides A2S.

Requirements

Docker for the validated Linux runtime path
Python 3 inside the Docker image for Barotrauma's native console terminal; the checked-in steamcmd-linux image includes it
For process mode: screen
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mybtserver create btserver

Run setup:

alphagsm mybtserver setup

Start it:

alphagsm mybtserver start

Check it:

alphagsm mybtserver status

Stop it:

alphagsm mybtserver stop

Setup Details

Setup configures:

the game port (default 27015)
the adjacent query port (default 27016)
the install directory
SteamCMD downloads the server files

Useful Commands

Native XML Workshop packages use anonymous SteamCMD access; no Steam account is required. Item and collection identifiers accept numeric IDs or Steam Community URLs.

alphagsm mybtserver mod add workshop https://steamcommunity.com/sharedfiles/filedetails/?id=2499918466
alphagsm mybtserver mod add workshop-collection COLLECTION_ID_OR_URL
alphagsm mybtserver mod list
alphagsm mybtserver mod apply
alphagsm mybtserver mod remove workshop 2499918466
alphagsm mybtserver mod apply
alphagsm mybtserver mod cleanup

Apply validates and downloads packages, stages owned files under LocalMods/alphagsm-ID, and enables their package names and file lists in config_player.xml. Start and update reapply desired state by default. Restart a running server after changing its mods. Existing operator settings and package entries are preserved. Cleanup clears desired items and removes only unchanged AlphaGSM-owned payloads and native entries; externally edited owned content causes a clear refusal. The download cache remains available.

This supports native regular XML packages, including multiplayer item and submarine content. Core replacements and Lua/CSharp packages needing a separate server executable require manual configuration. A configured package is reported as configured; the engine must load it before it is usable.

Set ALPHAGSM_RUN_WORKSHOP=1 when running run_btserver.sh to check the public BaroCraftables fixture through native enabled-package hashes and its loaded Welding Table prefab. On 13 October 2026, both process and Docker opt-in integration cases passed with these engine checks, CLI health commands and complete shutdown.

alphagsm mybtserver update
alphagsm mybtserver backup

Notes

Module name: btserver
Default game port: 27015
Default query port: 27016
query, info, and info --json use generic UDP health on the managed game port for both process and Docker.

Server variables

After create btserver, 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: DedicatedServer
Location: <install_dir>/DedicatedServer
Engine: Custom (SteamCMD)
SteamCMD App ID: 1026340

Server Configuration

Config files: config_player.xml, serversettings.xml
Max players: 16
Template: See server-templates/btserver/ if available

Maps and Mods

Map directory: Check game documentation
Mod directory: Check game documentation
Workshop support: Native regular XML packages through mod

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 Barotrauma?

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

Which runtimes can run Barotrauma?

Declared runtimes: Docker or a Linux host process.

Which ports does Barotrauma use?

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

Can I add mods to Barotrauma?

How should I back up Barotrauma?

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