Troubleshooting

Where to look first

App log:

docker compose logs -f auto-tournament

In the app, Admin Tools has a Server Events Monitor that shows events from each server as they arrive, and the Application Logs.

Server log, with CS2 Server Manager:

csm logs 1 200

FRONTEND_BASE_URL must be exactly the address in your browser, including http:// or https:// and the port.
With an https:// address, cookies are only sent over HTTPS. Behind a reverse proxy, the proxy must send X-Forwarded-Proto. See Reverse proxy.
Steam login needs the Steam Web API key in Settings → Sign-in → Steam. The Test button there checks it.

Ask an admin to turn on Is admin on your player, or add your email to Admin emails or your Steam64 ID to Admin Steam IDs in Settings → Sign-in → Admin access. If nobody can sign in as admin, run docker exec auto-tournament reset-admin on the host and open /setup. See First login.

Everyone is logged out after a restart

Set SESSION_SECRET in .env.

Server warnings

The Servers page shows a status for each server. Hover over a warning to see the details. What each one means and how to fix it: Server health warnings.

Tournaments and matches

Elimination does not accept my team count

Single and double elimination need 2, 4, 8, 16, 32, 64 or 128 teams. Use round robin (2 to 32) or Swiss (4 to 64) for other counts.

The veto does not start, or the map pool is rejected

Map veto needs a pool of exactly 7 maps. Use Active Duty or make a pool with 7 maps on Maps & Map Pools. Players must open their own team page and be signed in with Steam to see the veto buttons.

Maps are missing

Open Settings → Counter-Strike 2 and click Sync CS2 Maps. If GitHub rate-limits you, set GITHUB_TOKEN in .env.

A match is stuck after a restart

Open Admin Tools and click Run Match Recovery Now. See Running matches.

A match shows NEEDS ADMIN DECISION

The series ended level. Open the match and choose the winner. See Running matches.

The next match starts slowly on a server

After a series ends, the plugin keeps players on the server for a short time, and 60 seconds more when a demo is uploaded. The next match loads after that. See Simulation mode for the settings.

Demo uploads fail

Check that GOTV is on (tv_enable 1) on the server.
Behind nginx, set client_max_body_size 0. See Reverse proxy.

CS2 Server Manager

More fixes are in CS2 Server Manager troubleshooting.

A server does not start

Run it in the foreground to see the error:

csm debug 1

Try the other launcher:

csm start --alternate

Run csm doctor to find common problems.

`steamclient.so` is missing

The server fails with a Steamworks or steamclient.so error. Link the file and restart:

mkdir -p ~/.steam/sdk64
ln -sf ~/.local/share/Steam/steamcmd/linux64/steamclient.so ~/.steam/sdk64/steamclient.so
csm restart

Game files are broken

Rebuild one server from the main install:

csm reinstall 2

`Plugin uses old SourceHook Metamod build`

Metamod is too new for the current CounterStrikeSharp. Run csm update-plugins, which installs the Metamod version that works.