{"id":23104811,"url":"https://github.com/mayniklas/docker-csgo-server","last_synced_at":"2025-09-07T14:05:47.873Z","repository":{"id":109060813,"uuid":"271247922","full_name":"MayNiklas/docker-csgo-server","owner":"MayNiklas","description":null,"archived":false,"fork":false,"pushed_at":"2021-07-02T15:21:47.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-09T10:09:40.120Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MayNiklas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-10T10:31:14.000Z","updated_at":"2025-01-23T16:18:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"947d9edf-f4cd-44d2-8139-0c5aa3010acd","html_url":"https://github.com/MayNiklas/docker-csgo-server","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MayNiklas%2Fdocker-csgo-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MayNiklas%2Fdocker-csgo-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MayNiklas%2Fdocker-csgo-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MayNiklas%2Fdocker-csgo-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MayNiklas","download_url":"https://codeload.github.com/MayNiklas/docker-csgo-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247086027,"owners_count":20881160,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-17T00:36:26.644Z","updated_at":"2025-04-03T22:13:02.675Z","avatar_url":"https://github.com/MayNiklas.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-csgo-server\n\n---\n\n## Quick Start\n\n**NOTE**: The Docker command provided in this quick start is given as an example\nand parameters should be adjusted to your need.\n\nLaunch the csgo-server docker container with the following command:\n```\ndocker run --rm -d \\\n    -p \"27015:27015/udp\" \\\n    -p \"27015:27015/tcp\" \\\n    -e TOKEN=\u003cAPI-token\u003e \\\n    -v $(pwd)/cs-server:/home/cs \\\n    --name csgo-server \\\n    mayniki/csgo-server\n```\n\nWhere:\n  - `$(pwd)/cs-server:/home/cs`: This is where the application get's installed. In this case, your current directory is used.\n  - `TOKEN`: Insert your API token\n\nYou can also use the following, in case you don't want persistant data on your system:\n```\ndocker run --rm -d \\\n    -p \"27015:27015/udp\" \\\n    -p \"27015:27015/tcp\" \\\n    -e TOKEN=\u003cAPI-token\u003e \\\n    --name csgo-server \\\n    mayniki/csgo-server\n```\n\n## Motivation\n\nSince I haven't found a CS GO container I liked, I wrote my own.\n\nSince the install is really big, the Container just contains the instructions to download and install the game. The install is stored within a mounted volume instead of a temporary one. This has the advantage of the game not redownloading every time you\nrestart the container or change a parameter. The first time you star the container the game is getting installed and starts afterwards. Afterwards, it just starts the allready installed game. \n\nFeel free to fork the repository and change it to your liking.\n\n## Updates\n\nAs soon there is a new version of the game, the server will wait untill the current game finishes. It will automatically update the game before restarting itself.\n\n## Environment Variables\n\n| Variable       | Description                                  | Default |\n|----------------|----------------------------------------------|---------|\n|`TICKRATE`| The servers tickrate. You can set it to 64 if you want to | `32` |\n|`UID`| ID of the user the application runs as.  See [User/Group IDs](#usergroup-ids) to better understand when this should be set. | `1000` |\n|`GID`| ID of the group the application runs as.  See [User/Group IDs](#usergroup-ids) to better understand when this should be set. | `1000` |\n|`TOKEN`| Your API KEY - needed for publicly hosting a CS server | 'NULL' |\n|`WORKSHOPTOKEN`| Your Steam workshop API KEY - needed for accessing Workshop maps | 'NULL' |\n|`CSGO_HOSTNAME`| Enter the name of your CS server | 'NULL' |\n|`MAXPLAYERS`| Enter the maximum number of players beeing able to join | '10' |\n|`GAMETYPE`| Gametype - take a look at the CS wiki | '0' |\n|`GAMEMODE`| Gamemode - take a look at the CS wiki | '1' |\n|`MAPGROUP`| Default mapgroup | 'mg_bomb' |\n|`STARTMAP`| Default map | 'de_dust' |\n|`RCONPW`| Enter a RCON pw to controll the servers console in game | 'NULL' |\n|`PW`| Enter a pw being needed to join | 'NULL' |\n|`REGION`| Enter servers region | '3' |\n\n\n\n## docker-compose.yml\n\nHere is an example of a `docker-compose.yml` file that can be used with\n[Docker Compose](https://docs.docker.com/compose/overview/).\n\nMake sure to adjust according to your needs.\n\nThe file can be found within the repository and is getting cloned within it.\nTherefore: docker-compose up should work out of the box.\n\n\n```\nversion: '3'\nservices:\n  csgo-server:\n    container_name: csgo-server\n    image: mayniki/csgo-server\n#    volumes:\n#      - \"./cs:/home/cs\"\n    ports:\n      - \"27015:27015/udp\"\n      - \"27015:27015/tcp\" # Needed for RCON\n    environment:\n      - TICKRATE=128      # Set to 64 ticks by default\n#      - UID=\n#      - GID=\n#      - TOKEN=           # Include your CS:GO API key\n#      - WORKSHOPTOKEN=   # Needed to download workshop content\n#      - CSGO_HOSTNAME=\n#      - MAXPLAYERS=\n#      - GAMETYPE=\n#      - GAMEMODE=\n#      - MAPGROUP=\n#      - STARTMAP=\n#      - RCONPW=          # Set your RCON password here!\n#      - PW=              # Set if password should be requiered to join\n#      - REGION=\n\n    restart: unless-stopped\n    stdin_open: true\n    tty: true\n```\n\n\n## Configuration template\n\nUse `server.cfg.template` to add anything you'd like to include in the server\nconfiguration. Variables will be replaced accordingly. This requires you to build the container yourself from this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayniklas%2Fdocker-csgo-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmayniklas%2Fdocker-csgo-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayniklas%2Fdocker-csgo-server/lists"}