How to Add Workshop Maps to a CS2 Server

  • 8 min read
  • Updated
  • ESAGAMES Team

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

  1. 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/managegameservers using app ID 730 and pass it at launch with +sv_setsteamaccount. On Linux, start the server with the cs2.sh script in the game folder. 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_dust2
  2. Step 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 = 1234567890
  3. Step 3: Load a single map from the console

    In the server console (or over RCON), run host_workshop_map with 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 1234567890
  4. Step 4: Start the server on a Workshop map

    To boot straight into a Workshop map, add +host_workshop_map to your launch line. Commands can be passed at launch with a + prefix, just like +map. Set the game mode first with +game_alias (for example casual, competitive, wingman or deathmatch), so the map loads in the mode you want.

    ./cs2.sh -dedicated +sv_setsteamaccount YOUR_GSLT +game_alias casual +host_workshop_map 1234567890
  5. Step 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_collection with 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 -authkey for this.

    ./cs2.sh -dedicated +sv_setsteamaccount YOUR_GSLT +game_alias casual +host_workshop_collection 1234567890
    
    # or, on a running server
    host_workshop_collection 1234567890
  6. Step 6: Change maps

    Use the right command for the right map. ds_workshop_changelevel switches 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_map loads any other Workshop map by ID. changelevel handles 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 map
  7. Step 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_votenextmap lets 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. Set sv_workshop_allow_other_maps 0 to keep the server on your own list. Put these in game/csgo/cfg/server.cfg. Custom map groups in gamemodes_server.txt are 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 0
  8. Step 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 addons folders into game/csgo. Then open game/csgo/gameinfo.gi and add a line under Game_LowViolence so Metamod loads, and check it with meta 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 stock gameinfo.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.

Frequently asked questions

How do I add a Workshop map to my CS2 server?

Copy the number after ?id= on the map's Workshop page and run host_workshop_map <id> in the server console. To start on it, add +host_workshop_map <id> to your launch options. The server downloads the map from Steam and loads it.

How do I add a whole Workshop collection?

Make a public collection on the Steam Workshop and run host_workshop_collection <collection id>, at launch with a + or in the console. The server downloads every map and uses the collection as its map group.

Why doesn't map_workshop work on my server?

map_workshop is a client command for playing a Workshop map in your own game. A dedicated server uses host_workshop_map for single maps and host_workshop_collection for collections.

How do I switch between maps in my collection?

Use ds_workshop_changelevel <mapname> with the map's name (not its ID). For a Workshop map outside the collection, use host_workshop_map <id>. For stock maps, changelevel still works.

Do I need a Steam Web API key (authkey)?

Not for CS2. The -authkey was a CS:GO requirement for Workshop collections. CS2 downloads Workshop items over the server's own Steam connection. You do need a GSLT so players can join.

Do Workshop maps update automatically?

Don't count on it while a map is loaded. After a creator updates a map, run host_workshop_map or host_workshop_collection again, or restart the server, and watch the console for a new download.

Can I run Workshop maps in competitive or wingman?

Yes, if the map supports that mode. Set the mode with game_alias (competitive, casual, wingman, deathmatch) before loading the map, or put +game_alias ahead of the Workshop command in your launch line.

Fixes for when it goes wrong

Knowledge-base fixes that pair with this guide — the errors people hit after setup.

More guides

Skip the troubleshooting

Managed, protected hosting in Frankfurt — we handle the Linux, the network and the DDoS so you don't have to.