Nexardo

Counter-Strike 2 Field guide

CS2 Workshop maps: downloads and connection failures

Configure CS2 dedicated server Workshop map downloads using a Steam Web API key (-authkey) and resolve Map missing disconnects.

EugenePublishedUpdatedReading time3 min
CS2 Workshop maps: downloads and connection failures

Deploying custom maps from the Steam Workshop is one of the best ways to expand map pools for utility drills, retake servers, and community tournaments in Counter-Strike 2. However, administrators frequently encounter boot-time download failures or situations where connecting players receive a "Map missing" disconnect error.

This guide targets Linux CS2 dedicated server administrators. As of October 28, 2026, Counter-Strike 2 dedicated servers require authenticated Steam Web API access to query Workshop items, and traditional Source 1 FastDL setups are no longer supported.

Why dedicated servers require a Steam Web API key (-authkey)#

Unlike CS:GO, where dedicated servers could query public Workshop items anonymously, Counter-Strike 2 communicates with the Steam Web API to validate item ownership, query collection inventories, and resolve CDN endpoints.

Without an authorized API key provided at launch, the server prints Failed to query workshop item or Invalid AuthKey and aborts .vpk map downloads.

Generate your key on Steam's developer portal:

text
https://steamcommunity.com/dev/apikey

Pass the key directly via the startup command line:

bash
-authkey YOUR_STEAM_WEB_API_KEY

Store this token securely in protected environment variables or startup scripts with 600 permissions; never commit API credentials into public version control.

Launching a standalone map or a Workshop collection#

There are two primary methods for hosting Workshop content:

  1. A single specific map: pass the item's PublishedFileId (found in the Workshop page URL):
bash
./game/bin/linuxsteamrt64/cs2 -dedicated \
  -port 27015 \
  -authkey "YOUR_STEAM_WEB_API_KEY" \
  +host_workshop_map 3070244462
  1. A multi-map Workshop collection: specify both collection ID and initial start map:
bash
./game/bin/linuxsteamrt64/cs2 -dedicated \
  -port 27015 \
  -authkey "YOUR_STEAM_WEB_API_KEY" \
  +host_workshop_collection 3070255591 \
  +workshop_start_map 3070244462

The dedicated server process downloads the .vpk archive and caches it in a structured directory:

bash
ls -la /srv/cs2/game/csgo/maps/workshop/
Workshop integration: authkey validation, caching vpk files on server, and direct client delivery via Valve CDN.

Resolving "Map missing" errors for connecting players#

Under Source 2, clients no longer download map assets from the game server or an external HTTP FastDL host. All client downloads originate directly from Valve's global content delivery network (Steam CDN).

If connecting players disconnect with Map missing or Disconnected: Failed to download map, check:

  1. Workshop visibility status: The map must be set to Public. If the author marks the item Hidden, Unlisted, or Friends Only, clients cannot fetch it from Valve CDN.
  2. Filesystem write permissions: Ensure your cs2 service user owns and can write to the Workshop maps cache:
bash
chown -R cs2:cs2 /srv/cs2/game/csgo/maps/workshop
chmod -R 755 /srv/cs2/game/csgo/maps/workshop
  1. Corrupted server-side cache: If an earlier download stalled mid-stream, the cached .vpk file may be truncated. Delete the affected map folder and restart:
bash
rm -rf /srv/cs2/game/csgo/maps/workshop/3070244462

Changing Workshop maps on the fly#

Administrators can switch Workshop maps dynamically during gameplay using the server console or RCON:

bash
rcon host_workshop_map 3070244462

The server fetches the required .vpk file if not already present locally and transitions all connected players immediately once downloaded.

If you manage training infrastructure through Nexardo, centralize Steam Web API credentials and collection definitions within deployment profiles: uniform environment templates prevent rotation failures across your dedicated instances.

Sources#