Dedicated server guide

Team Fortress 2

Manage team-fortress-2 with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Not recorded in the support snapshot · Support evidence: 2026-10-16.

Build setup commands

Runtime familyunknown

Runtime support is unknown in this snapshot; review the game guide.

Network bindings

Port numbers and protocols are unknown in this snapshot; review the game guide and configuration.

Mods and plugins

Mod support is unknown in this snapshot; review the game guide before adding mods.

Backup hook

Backup hook support is unknown in this snapshot; review the game guide for backup and restore procedures.

Choose a supported runtime

Linux and Docker quickstart

This guide has no recorded support entry. Review the upstream guide and current support notes before attempting setup.

Use the upstream guide and support notes to review this module’s requirements before attempting installation or launch.

This guide is for running a Team Fortress 2 server with AlphaGSM.

What You Need

screen
SteamCMD runtime libraries:
- lib32gcc-s1
- lib32stdc++6
the Python packages in requirements.txt

Quick Start

Create the server:

alphagsm mytf2 create teamfortress2

Run setup:

alphagsm mytf2 setup

Start it:

alphagsm mytf2 start

Check it:

alphagsm mytf2 status

Stop it:

alphagsm mytf2 stop

Useful Commands

alphagsm mytf2 update
alphagsm mytf2 update -r

-r restarts after the SteamCMD update. See Updating Servers And AlphaGSM.

Mod Sources

The full copy-paste walkthrough is Installing Mods. TF2 mod installs distinguish between AlphaGSM-owned manifest entries and external provider ids.

manifest means AlphaGSM resolves the mod from its own checked-in registry. Use this for known entries such as SourceMod and MetaMod when you want the most predictable result.
gamebanana means you provide a numeric GameBanana item id and AlphaGSM resolves the current downloadable archive from GameBanana.
moddb means you provide a canonical Mod DB download or addon page URL and AlphaGSM resolves Mod DB's start-download link when the file is a supported zip or tar archive.
workshop means you provide a numeric Steam Workshop item id and AlphaGSM tries to download it through SteamCMD.
GameBanana, Mod DB, and Workshop are shared external providers, not TF2-owned registries. TF2 currently just consumes those provider integrations.
curated still works as a compatibility alias for manifest.

Examples:

alphagsm mytf2 mod add manifest metamod
alphagsm mytf2 mod add manifest sourcemod
alphagsm mytf2 mod add gamebanana 12345
alphagsm mytf2 mod add moddb https://www.moddb.com/mods/cage-eight/downloads/cage-eight
alphagsm mytf2 mod add workshop 1234567890
alphagsm mytf2 mod apply
alphagsm mytf2 mod cleanup

Use mod cleanup when you want AlphaGSM to remove files it previously installed and reset the tracked TF2 mod state.

Best Working Example

The best full example in the repository is:

tests/smoke_tests/run_tf2.sh

It uses this command flow:

alphagsm ittf2 create teamfortress2
alphagsm ittf2 setup -n PORT /tmp/tf2-server
alphagsm ittf2 start
alphagsm ittf2 status
alphagsm ittf2 stop
alphagsm ittf2 status

Notes

tf2 is the short name people usually type.
setup can take a while because TF2 installs through SteamCMD.
if you want the most realistic example, follow the smoke test.

Server variables

After create teamfortress2, 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
`dir`	—	string	Install directory for the server.
`exe_name`	—	string	Server executable filename.
`map`	gamemap, startmap, level, worldname	string	The currently selected map or level. Example: `cp_dustbowl`.
`maxplayers`	users	integer	Maximum number of player slots. Example: `16`.
`port`	gameport	integer	The primary game port. Example: `27015`.
`rconpassword`	rconpass, querypassword, query_administrator_password	string	Remote console password for administrative access. Stored as a secret.
`servername`	hostname, name	string	The server's public name shown to players. Example: `AlphaGSM TF2 Server`.
`serverpassword`	sv_password, password	string	Password required for players to join the server. Stored as a secret.

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 Team Fortress 2?

Not recorded in the support snapshot. This guide has no recorded support entry. Review the upstream guide and current support notes before attempting setup.

Which runtimes can run Team Fortress 2?

Runtime support is unknown in this snapshot; review the game guide.

Which ports does Team Fortress 2 use?

Port numbers and protocols are unknown in this snapshot; review the game guide and configuration.

Can I add mods to Team Fortress 2?

Mod support is unknown in this snapshot; review the game guide before adding mods.

How should I back up Team Fortress 2?

Backup hook support is unknown in this snapshot; review the game guide for backup and restore procedures.

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