Dedicated server guide

Teeworlds

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

Authentication required · Support evidence: 2026-10-16.

Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

8303/UDP, 8303/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

Authentication is required before installation; follow the game guide for credentials, ownership and login prerequisites.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Authentication is required before installation; follow the game guide for credentials, ownership and login prerequisites.

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

./alphagsm-docker start
./alphagsm-docker my-twserver create twserver
./alphagsm-docker my-twserver setup
./alphagsm-docker my-twserver start
./alphagsm-docker my-twserver status

Host process

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

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

This guide covers the twserver module in AlphaGSM.

Status

twserver is currently ENABLED (AUTH) on the documented Ubuntu 24.04 Linux baseline.

Before setup, authenticate Steam or SteamCMD with an account entitled to server app 380840. The current GitHub integration lane still validates both process and Docker runtime selection around that auth-gated prerequisite, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

screen
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mytwserver create twserver

Run setup:

alphagsm mytwserver setup

Start it:

alphagsm mytwserver start

Check it:

alphagsm mytwserver status

Stop it:

alphagsm mytwserver stop

Setup Details

Setup configures:

the game port (default 8303)
the install directory
SteamCMD downloads the server files

Useful Commands

alphagsm mytwserver update
alphagsm mytwserver backup
alphagsm mytwserver set port 8304
alphagsm mytwserver set servername "AlphaGSM Teeworlds Server"

set port and set servername rewrite autoexec.cfg immediately. The shared alias layer also accepts hostname and maps it to the Teeworlds servername setting.

Notes

Module name: twserver
Default port: 8303

Server variables

After create twserver, inspect or change these with set:

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

Key	Aliases	Type	What it does
`port`	gameport	integer	The UDP/TCP game port Teeworlds listens on.
`servername`	hostname, name	string	The advertised server name.

Developer Notes

Run File

Executable: teeworlds_srv
Location: <install_dir>/teeworlds_srv
Engine: Custom (SteamCMD)
SteamCMD App ID: 380840

Server Configuration

Config file: autoexec.cfg
Template: See server-templates/twserver/ if available
Schema-backed sync: AlphaGSM keeps sv_port and sv_name in sync with set port / set servername

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.

autoexec.cfg

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

Authentication required. Authentication is required before installation; follow the game guide for credentials, ownership and login prerequisites.

Which runtimes can run Teeworlds?

Declared runtimes: Docker or a Linux host process.

Which ports does Teeworlds use?

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

Can I add mods to Teeworlds?

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

How should I back up Teeworlds?

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