A practical walkthrough for running Steam Workshop maps on your own Counter-Strike 2 dedicated server. Find a map's Workshop ID, load it with host_workshop_map, host a whole collection as a rotation, switch maps cleanly and fix the downloads that fail. There's also the hosted route if you'd rather skip the command line.
Counter-Strike 2 community servers can host maps straight from the Steam Workshop. You don't copy map files around by hand. You give the server a Workshop ID, and it downloads the map from Steam and loads it. The same works for a whole Workshop collection, which turns into a map rotation for your server.
The tricky parts are knowing which command does what: single map vs. collection, and server console vs. your own game console. You also need the server set up correctly before downloads work: a Game Server Login Token (GSLT) and a working Steam connection. This guide covers all of it in order.
You can do this on a self-hosted CS2 server, as shown below. If you want it online 24/7 without the setup, our CS2 server hosting gives you a web game panel with file manager and console, NVMe storage and always-on Anti-DDoS in Frankfurt.
What you'll need
- A working CS2 dedicated server (Steam app 730, about 60 GB) on Windows or Linux.
- A Game Server Login Token for app 730, passed with
+sv_setsteamaccount. - Public Workshop maps or a public Workshop collection, plus their IDs.
- Outbound internet access to Steam so the server can download items.
- Free disk space for every Workshop map you plan to host.
- Optionally Metamod:Source 2.x + CounterStrikeSharp for map-vote and admin plugins.
Add Workshop maps to a CS2 dedicated server, step by step
Step 1: Get the server running with a GSLT
The CS2 server is Steam app 730, the same app ID as the game client, so expect a download of around 60 GB. Players can only join your server if it has a Game Server Login Token. Generate one at
steamcommunity.com/dev/managegameserversusing app ID 730 and pass it at launch with+sv_setsteamaccount. On Linux, start the server with thecs2.shscript in thegamefolder. Always include-dedicated.steamcmd +force_install_dir /home/steam/cs2-ds +login anonymous +app_update 730 validate +quit # from /home/steam/cs2-ds/game ./cs2.sh -dedicated +sv_setsteamaccount YOUR_GSLT +map de_dust2Step 2: Find the map's Workshop ID
Open the map's page on the Steam Workshop. The Workshop ID is the number after
?id=in the address. Make sure the item is published publicly. A map set to Private or Friends-only can't be downloaded by your server. Note the map's file name too, because you'll use it later to switch maps inside a collection.https://steamcommunity.com/sharedfiles/filedetails/?id=1234567890 # Workshop ID = 1234567890Step 3: Load a single map from the console
In the server console (or over RCON), run
host_workshop_mapwith the ID. The server downloads the map from Steam if it doesn't have it yet, then changes level to it. The first load can take a while. Workshop maps can be large (Valve allows uploads of up to 3 GB), so give it time before assuming it failed.host_workshop_map 1234567890Step 4: Start the server on a Workshop map
To boot straight into a Workshop map, add
+host_workshop_mapto your launch line. Commands can be passed at launch with a+prefix, just like+map. Set the game mode first with+game_alias(for examplecasual,competitive,wingmanordeathmatch), so the map loads in the mode you want../cs2.sh -dedicated +sv_setsteamaccount YOUR_GSLT +game_alias casual +host_workshop_map 1234567890Step 5: Host a whole Workshop collection
For a rotation, create a collection on the Steam Workshop, add your maps and set it to Public. Then use
host_workshop_collectionwith the collection's ID, which is also the number after?id=on its page. The server downloads every map in the collection and builds a map group from them. Requirements: the collection and its maps must be public, the server must be able to reach Steam, and you need enough disk space for all the maps. Unlike CS:GO, CS2 doesn't use a Steam Web API-authkeyfor this../cs2.sh -dedicated +sv_setsteamaccount YOUR_GSLT +game_alias casual +host_workshop_collection 1234567890 # or, on a running server host_workshop_collection 1234567890Step 6: Change maps
Use the right command for the right map.
ds_workshop_changelevelswitches to a Workshop map the server already has, such as one from your hosted collection. It takes the map name, not the ID.host_workshop_maploads any other Workshop map by ID.changelevelhandles stock maps that ship with the game.ds_workshop_changelevel mapname # a Workshop map already on the server host_workshop_map 1234567890 # any Workshop map, by ID changelevel de_inferno # a stock mapStep 7: Control the rotation
With a collection loaded, the server cycles through the collection's map group at the end of each match. By default,
mp_endmatch_votenextmaplets players vote for the next map on the final scoreboard. While the server is empty, players can also start other Workshop maps on it before it cycles back to your collection. Setsv_workshop_allow_other_maps 0to keep the server on your own list. Put these ingame/csgo/cfg/server.cfg. Custom map groups ingamemodes_server.txtare best kept for maps that are already on disk. For Workshop maps, a collection is the dependable way to rotate.// game/csgo/cfg/server.cfg mp_endmatch_votenextmap 1 sv_workshop_allow_other_maps 0Step 8: (Optional) Add plugins for map votes and admin
For RTV, nominations or admin menus, most CS2 communities run Metamod:Source 2.x with CounterStrikeSharp on top. Copy both
addonsfolders intogame/csgo. Then opengame/csgo/gameinfo.giand add a line underGame_LowViolenceso Metamod loads, and check it withmeta list. Community map-vote plugins can mix stock and Workshop maps. Each one has its own map-list format, so follow the plugin's documentation. A game update or validate can restore the stockgameinfo.gi, so check that line after updates.// game/csgo/gameinfo.gi Game_LowViolence csgo_lv Game csgo/addons/metamod // add this line # then, in the server console: meta list
Run Workshop maps smoothly
Use a collection for rotations
One collection is easier to maintain than a list of IDs in launch options. Add or remove maps on Steam, then reload the collection on the server. Your rotation updates without touching config files.
Expect a slow first load
Each map downloads on first use, and large maps take time. Load a new collection when the server is quiet, before your players arrive.
One GSLT per server
Every server you run needs its own Game Server Login Token for app 730. Players can't join a server without one, and sharing a token between servers is asking for trouble.
Leave disk headroom
CS2 itself is around 60 GB, and a big collection adds several more. Fast NVMe storage also shortens map loads and level changes.
Common problems & fixes
The map never downloads / the console says it failed to download
Check that the item is public and that you used the right ID: a map ID with host_workshop_map, a collection ID with host_workshop_collection. Make sure the server can reach Steam, then retry and watch the console for the download lines.
"Unknown command" for host_workshop_map
You're typing it in your game client, not the server. Use the server console or RCON. In your own game, Workshop maps are started from the Play menu instead.
Players can't join the server
The server has no valid GSLT. Generate one for app ID 730, launch with +sv_setsteamaccount YOUR_GSLT, and open the game port (27015 by default) for UDP.
Linux: Failed to load module steamclient.so
SteamCMD didn't put steamclient.so where CS2 looks for it, so the server can't talk to Steam or download Workshop items. Symlink steamcmd/linux64/steamclient.so into ~/.steam/sdk64/, creating the folder if needed.
The server keeps jumping to maps outside my collection
While the server is empty, players can start other Workshop maps on it. Set sv_workshop_allow_other_maps 0 to keep it on your collection.
Plugins stopped loading after a CS2 update
The update restored the stock gameinfo.gi. Add the Game csgo/addons/metamod line back under Game_LowViolence, restart, and check with meta list. Then update Metamod and CounterStrikeSharp if they need it.
Counter-Strike, Counter-Strike 2, Steam and the Steam Workshop are trademarks of Valve Corporation. Workshop maps are the work of their respective creators. Metamod:Source and CounterStrikeSharp are open-source projects of their respective authors. ESAGAMES is an independent hosting provider, not affiliated with or endorsed by Valve. Players need a legitimate copy of the game to join Steam-secured servers.