Game Servers

Team Fortress 2 Classified server

Run a Team Fortress 2 Classified dedicated server with LinuxGSM, in Docker or directly on Linux.

tf2cserver Docker tf2cSource

Run with Docker

First install Docker Engine and the Compose plugin on your Linux host. Run the commands below as a user allowed to access Docker; otherwise prefix Docker commands with sudo. The container manages its own linuxgsm user.

The tf2c image has LinuxGSM and every dependency for Team Fortress 2 Classified already installed on Ubuntu 26.04. On first start it downloads the game server, then keeps it updated.

1. Create docker-compose.yml

Give the server a directory of its own and create the file inside it. Docker Compose looks for docker-compose.yml in the directory you run it from, so run every docker compose command below from this directory. Each server needs its own directory.

shell
mkdir -p ~/docker/tf2cserver
cd ~/docker/tf2cserver
nano docker-compose.yml

Paste in one of the files below, then save and exit (in nano: CTRL+o, Enter, CTRL+x). The server's files will be stored in ~/docker/tf2cserver/tf2cserver, next to docker-compose.yml.

The server uses the host's ports directly, the way it would without Docker. Query ports and server browsers work with no extra setup.

docker-compose.yml
services:
  tf2cserver:
    image: ghcr.io/gameservermanagers/gameserver:tf2c
    container_name: tf2cserver
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./tf2cserver:/data
    environment:
      - UPDATE_CHECK=60

The container gets its own network and publishes the default ports. If you change a port in the server's config, change it here too. Bridge networking can hide the server's real IP from the game, which breaks some server browsers.

docker-compose.yml
services:
  tf2cserver:
    image: ghcr.io/gameservermanagers/gameserver:tf2c
    container_name: tf2cserver
    restart: unless-stopped
    ports:
      - "27015:27015/udp"
      - "27015:27015/tcp"
      - "27020:27020/udp"
      - "27005:27005/udp"
    volumes:
      - ./tf2cserver:/data
    environment:
      - UPDATE_CHECK=60

Also published on Docker Hub as gameservermanagers/gameserver:tf2c. Prefer docker run? See Docker help.

2. Start it

shell
cd ~/docker/tf2cserver
docker compose up -d
docker compose logs -f

The first start installs the server, which can take a while for large games. When it is ready the log shows the server details, including ports and passwords.

Ports

With host networking the server uses the host's ports directly. With bridge networking the compose file above publishes them. Either way, open them in your firewall.

PortDefaultProtocol
Game27015UDP
Query27015TCP
RCON27015TCP
SourceTV27020UDP
Client27005UDP

These are the defaults. Run details to see every port the server uses and its protocol.

Manage the server

Show details, ports and passwords
docker exec -it --user linuxgsm tf2cserver ./tf2cserver details
Open the live console (leave with CTRL+b then d)
docker exec -it --user linuxgsm tf2cserver ./tf2cserver console
Restart the game server
docker restart tf2cserver
Check for a game update now
docker exec -it --user linuxgsm tf2cserver ./tf2cserver update
Update the image
cd ~/docker/tf2cserver
docker compose pull && docker compose up -d

Server files, configs and logs live in ~/docker/tf2cserver/tf2cserver on the host: back up that directory. Docker help below covers permissions, environment variables and bridge networking.

Docker help

Images and tags

Images are built weekly and published to two registries. They are identical, so use whichever you prefer.

RegistryImage
GitHub Container Registryghcr.io/gameservermanagers/gameserver:tf2c
Docker Hubgameservermanagers/gameserver:tf2c

The image uses the base OS LinuxGSM recommends for this game. You do not need to match it on the host.

Use docker run instead of Compose
shell
docker run -d \
  --name tf2cserver \
  --network host \
  --restart unless-stopped \
  -v "$PWD/tf2cserver:/data" \
  -e UPDATE_CHECK=60 \
  ghcr.io/gameservermanagers/gameserver:tf2c

With bridge networking, publish the default ports instead of --network host:

shell
docker run -d \
  --name tf2cserver \
  -p 27015:27015/udp \
  -p 27015:27015/tcp \
  -p 27020:27020/udp \
  -p 27005:27005/udp \
  --restart unless-stopped \
  -v "$PWD/tf2cserver:/data" \
  -e UPDATE_CHECK=60 \
  ghcr.io/gameservermanagers/gameserver:tf2c
Data and permissions

Everything that should survive a container update lives in /data inside the container, which is ./tf2cserver next to docker-compose.yml on the host.

Path in /dataContents
serverfiles/The game server itself
config-lgsm/LinuxGSM config, including common.cfg
log/Script, console and game logs
data/LinuxGSM data and cache

The game server runs as the linuxgsm user, not root. On every start the container sets that user to UID and GID (both 1000 by default) and takes ownership of /data. If your host user has a different ID, set them to match so you can edit files on the host:

docker-compose.yml
environment:
      - UID=1001
      - GID=1001
Environment variables
VariableDefaultWhat it does
UPDATE_CHECK60Minutes between update checks, from 1 to 59, or 60 for hourly. 0 turns scheduled checks off.
UPDATE_ON_STARTtrueCheck for a game update every time the container starts.
VALIDATE_ON_STARTfalseRun a SteamCMD validate on start. Slow, but repairs broken files.
UID / GID1000User and group IDs the game server runs as.
LGSM_GITHUBBRANCHmasterLinuxGSM branch to run. Set develop to test unreleased fixes.
Updates and health checks

The game server updates itself. The container checks every UPDATE_CHECK minutes and on start. If an update is out, it stops the server, updates it and starts it again.

The image brings new LinuxGSM releases, dependency fixes and OS updates. Pull it now and then with docker compose pull && docker compose up -d.

The image runs LinuxGSM's monitor as the Docker health check every minute, so docker ps shows whether the game server is answering, not just whether the container is up.

Bridge networking

network_mode: host is the simplest choice: the game server uses the host's ports directly, the way it would without Docker, and query ports work without extra setup.

If you need bridge networking, choose Bridge networking in step 1 for a compose file that publishes the default ports. If you change a port in the server's config, change it there too.

Bridge networking can hide the server's real IP from the game, which breaks some server browsers. Use host networking if players cannot find the server.

Troubleshooting
  • Permission denied in /data: set UID and GID to the owner of the host directory.
  • Server not listed in game: check the ports are open, use host networking, and add a GSLT if the game needs one.
  • Install fails at SteamCMD: the game may need a Steam login. Check the notes at the top of this page.
  • Will not start: stop the container, then run docker compose run --rm tf2cserver debug to see why.
  • Still stuck: run details and debug, then ask on Discord or GitHub Discussions with the output.

Install on Linux

Install directly on a server running Ubuntu 26.04, Debian 11 or Enterprise Linux 8.

1. Create a user and log in

Creating users and installing system packages require administrator privileges. From your administrator account, use sudo below (omit it if already root). Install curl, tar and an editor such as nano with your distribution's package manager first.

administrator shell
sudo adduser tf2cserver

Give the user a strong password, then switch to its login shell:

administrator shell
sudo su - tf2cserver

Run all remaining commands as tf2cserver from its home directory, without sudo. On Enterprise Linux, create the account with sudo useradd -m tf2cserver and set its password with sudo passwd tf2cserver instead of adduser.

2. Download LinuxGSM

shell
curl -Lo linuxgsm.sh https://linuxgsm.sh && chmod +x linuxgsm.sh && bash linuxgsm.sh tf2cserver

3. Install

shell
./tf2cserver install

LinuxGSM checks dependencies and installs the game files. If this user has sudo access, it can install missing packages when prompted. Otherwise, ask an administrator to install the packages listed by LinuxGSM, then rerun this command as tf2cserver. Running ./tf2cserver install as root only installs dependencies, not the game server.

4. Configure and start the server

Review your LinuxGSM settings in lgsm/config-lgsm/tf2cserver/tf2cserver.cfg (instance settings) or lgsm/config-lgsm/tf2cserver/common.cfg (shared settings). Do not edit _default.cfg, which LinuxGSM updates automatically. Game settings use a separate config file; run ./tf2cserver details to find its path. Once configured, start the server explicitly:

shell
./tf2cserver start

Ports

Open these ports in your firewall. They are the defaults; run ./tf2cserver details to see the ports your server uses.

PortDefaultProtocol
Game27015UDP
Query27015TCP
RCON27015TCP
SourceTV27020UDP
Client27005UDP

Common commands

Start the server
start
./tf2cserver start
Stop the server
stop
./tf2cserver stop
Restart the server
restart
./tf2cserver restart
Show details, ports and passwords
./tf2cserver details
Open the live console (leave with CTRL+b then d; CTRL+c stops the server)
./tf2cserver console
Update the game server
./tf2cserver update
Run in the foreground to debug
./tf2cserver debug
Back up the whole server
./tf2cserver backup
List every command
./tf2cserver

Automate with cron

Restart the server if it crashes, apply game updates and keep LinuxGSM current. Add these with crontab -e.

crontab
*/5 * * * * /home/tf2cserver/tf2cserver monitor > /dev/null 2>&1
*/30 * * * * /home/tf2cserver/tf2cserver update > /dev/null 2>&1
0 0 * * 0 /home/tf2cserver/tf2cserver update-lgsm > /dev/null 2>&1

Deploy from a cloud marketplace

LinuxGSM is available as a one-click app on two cloud providers. You get a fresh Ubuntu server with LinuxGSM ready to use, then install Team Fortress 2 Classified on it.

Akamai (Linode) Marketplace

  1. Open LinuxGSM on the Akamai Marketplace and start a deploy.
  2. Choose a limited sudo username and, under the advanced options, set the game server name to tf2cserver.
  3. Pick any plan with enough CPU, memory and disk for Team Fortress 2 Classified, then create the instance.
  4. When it has finished setting up, log in over SSH or the Lish console and read the generated passwords, then switch to the linuxgsm user and install:
shell
cat /home/YOUR_USERNAME/.credentials
su linuxgsm
cd /home/linuxgsm
./tf2cserver install

Akamai does not keep this app updated for you, so run ./tf2cserver update-lgsm now and then. Details are in the Akamai guide.

DigitalOcean Marketplace

Create a Droplet from the LinuxGSM 1-Click App, choosing a size with enough resources for Team Fortress 2 Classified. Log in over SSH and follow the Linux install steps for tf2cserver.

Remember to open the game's ports in the provider's cloud firewall as well as on the server.