The Dockerfile will build an image for running a Counter-Strike: Global Offensive dedicated server in a container.
The following addons and plugins are included by default:
To get a 10man/gather going, simply connect and type .setup
in chat. Practice Mode should also be available from the menu.
Retakes is disabled by default. To enable it, set the environment variable RETAKES=1
and restart the container. Use can later use the cvar sm_retakes_enabled 0
to turn if off on-demand.
docker pull kmallea/csgo:latest
To use the image as-is, run it with a few useful environment variables to configure the server:
docker run \
--rm \
--interactive \
--tty \
--detach \
--mount source=csgo-data,target=/home/steam/csgo \
--network=host \
--env "SERVER_HOSTNAME=hostname" \
--env "SERVER_PASSWORD=password" \
--env "RCON_PASSWORD=rconpassword" \
--env "STEAM_ACCOUNT=gamelogintoken" \
--env "AUTHKEY=webapikey" \
--env "SOURCEMOD_ADMINS=STEAM_1:0:123456,STEAM_1:0:654321" \
kmallea/csgo
Would you rather use a bind volume so that you can access file contents directly? Use --mount type=bind,source=$(pwd),target=/home/steam/csgo
instead of the one in the example above.
If you plan on managing plugins manually with a bind volume, you might want pass an empty or reduced INSTALL_PLUGINS
environment variable to prevent conflicts (see below for default value of INSTALL_PLUGINS
).
The STEAM_ACCOUNT
is a "Game Login Token" required by Valve to run public servers. Confusingly, this token is also referred to as a steam account (it's set via sv_setsteamaccount
). To get one, visit https://steamcommunity.com/dev/managegameservers. You'll need one for each server.
Remember that if you DO NOT give a valid Game Login Token, your server will be restricted to LAN only
To access maps and collections from the Workshop, you need to provide a Steam Web API key. You can provide this via the evironment variable AUTHKEY
and it will be passed to the command-line as -authkey <key>
.
If you don't have a key you can generate one at http://steamcommunity.com/dev/apikey.
With a key set, you can also use the environment variables HOST_WORKSHOP_COLLECTION
and WORKSHOP_START_MAP
to specify a workshop collection and start the server with a workshop map, respectively.
For more information check out the Valve developer wiki page.
The optional SOURCEMOD_ADMINS
environment variable is a comma-delimited list of Steam IDs. These will be added to SourceMod's admin list before the server is started.
If you're on a LAN, add the environment variable LAN=1
(e.g., --env "LAN=1"
) to have sv_lan 1
set for you in the server.
Below are the default values for environment variables that control the server configuration. To override, pass one or more of these to docker using the -e
or --env
argument (example above).
SERVER_HOSTNAME=Counter-Strike: Global Offensive Dedicated Server
SERVER_PASSWORD=
RCON_PASSWORD=changeme
STEAM_ACCOUNT=changeme
AUTHKEY=changeme
IP=0.0.0.0
PORT=27015
TV_PORT=27020
TICKRATE=128
FPS_MAX=400
GAME_TYPE=0
GAME_MODE=1
MAP=de_dust2
MAPGROUP=mg_active
HOST_WORKSHOP_COLLECTION=
WORKSHOP_START_MAP=
MAXPLAYERS=12
TV_ENABLE=1
LAN=0
SOURCEMOD_ADMINS=
RETAKES=0
NOMASTER=0
For compatibility with the Docker secrets feature the following environment variables are also available as a '_FILE' variant.
SERVER_PASSWORD_FILE
RCON_PASSWORD_FILE
STEAM_ACCOUNT_FILE
AUTHKEY_FILE
SOURCEMOD_ADMINS_FILE
If one of these is set the content of the referred file is used as content for the non-'_FILE" environment variable. If both environment variables are set, the content of the non-'_FILE' variable takes precedence.
Usage of _FILE variables allows constructs like this in docker compose files:
version: "3.7"
services:
app:
image: kmallea/csgo
secrets:
- csgo_rcon_password
environment:
- RCON_PASSWORD_FILE=/run/secrets/csgo_rcon_password
secrets:
csgo_rcon_password:
file: ${SECRETS_DIR}/csgo_rcon_password.txt
PugSetup's default configuration can also be controlled via environment variables. Any environment variables prefixed with SM_PUGSETUP_
will have its corresponding cvar updated inside of $CSGODIR/csgo/cfg/sourcemod/pugsetup.cfg
.
NOTE: pugsetup.cfg
is automatically generated the first time the plugin is loaded. So you may have to restart the container after the first run so that the file exists.
For example, if I wanted to enable set the cvars sm_pugsetup_snake_captain_picks
and sm_pugsetup_message_prefix
, I would set the following environment variables when starting the container:
...
--env "SM_PUGSETUP_SNAKE_CAPTAIN_PICKS=2" \
--env "SM_PUGSETUP_MESSAGE_PREFIX=[{YELLOW}Sesame Street{NORMAL}]" \
...
This would set these values in $CSGODIR/csgo/cfg/sourcemod/pugsetup.cfg
:
...
sm_pugsetup_snake_captain_picks "2"
sm_pugsetup_message_prefix "[{YELLOW}Sesame Street{NORMAL}]"
...
If you're unable to use --network=host
, you'll need to publsh the ports instead, e.g.:
docker run \
--rm \
--interactive \
--tty \
--detach \
--mount source=csgo-data,target=/home/steam/csgo \
--publish 27015:27015/tcp \
--publish 27015:27015/udp \
--publish 27020:27020/tcp \
--publish 27020:27020/udp \
--env "SERVER_HOSTNAME=hostname" \
--env "SERVER_PASSWORD=password" \
--env "RCON_PASSWORD=rconpassword" \
--env "STEAM_ACCOUNT=gamelogintoken" \
--env "AUTHKEY=webapikey" \
--env "SOURCEMOD_ADMINS=STEAM_1:0:123456,STEAM_1:0:654321" \
kmallea/csgo
docker build -t csgo-dedicated-server .
OR
make
The game data is downloaded on first run (~26GB). Mount a volume to preserve game data if you need to recreate the container. The volume's target should be /home/steam/csgo
. In these example I use a data volume, but you can use a bind volume as well since plugins are installed during container startup.
SteamCMD is installed directly into the image at build time. To override the URL it installs from, pass in a build arg named STEAMCMD_URL
:
docker build \
-t $(IMAGE_NAME) \
--build-arg STEAMCMD_URL=https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz \
.
All plugins and extensions are installed during the startup of the container. This allows plugins can be managed via an environment variable.
The environment variable INSTALL_PLUGINS
contains a space-delimited list of plugins to install. You can use newlines to delimit, they will be converted to spaces before processing. If you override this, make sure you include metamod and sourcemod or plugins that depend on them won't work.
INSTALL_PLUGINS="${INSTALL_PLUGINS:-https://mms.alliedmods.net/mmsdrop/1.10/mmsource-1.10.7-git971-linux.tar.gz
https://sm.alliedmods.net/smdrop/1.10/sourcemod-1.10.0-git6478-linux.tar.gz
https://github.com/splewis/csgo-pug-setup/releases/download/2.0.5/pugsetup_2.0.5.zip
https://github.com/splewis/csgo-retakes/releases/download/v0.3.4/retakes_0.3.4.zip
https://github.com/b3none/retakes-instadefuse/releases/download/1.4.0/retakes-instadefuse.smx
https://github.com/b3none/retakes-autoplant/releases/download/2.3.0/retakes_autoplant.smx
https://github.com/b3none/retakes-hud/releases/download/2.2.5/retakes-hud.smx
}"
Lastly, a checksum is generated for each plugin's URL and is stored as $CSGO_DIR/csgo/<checksum>.marker
to prevent re-downloading plugins that have already been installed.
The directory containerfs
(container filesystem) is the equivalent of the steam user's home directory (/home/steam
). The csgo
game data lives in here. This means that any files you want to add, simply put them in the correct paths under containerfs
, and they will appear in the Docker image relative to the steam user's home directory.
It is recommended to use INSTALL_PLUGINS
environment variable at run time to install plugins, so that they are decoupled from the image.
See INSTALL_PLUGINS
above in the section above to learn about installing plugins.
If you're using a data volume, you can use the docker cp
command to copy files from your host machine into the data volume.
If you're using a bind volume, you can copy files in directly. You may want to clear the INSTALL_PLUGINS
variable if you want to manage everything manually.
After building:
Makefile
to your likingmake server
to start a local LAN server to testmake test
to run tests