{"id":13696299,"url":"https://github.com/spezifanta/hldm-docker","last_synced_at":"2025-05-03T17:30:53.045Z","repository":{"id":105145919,"uuid":"135208918","full_name":"spezifanta/hldm-docker","owner":"spezifanta","description":"Half Life Deatchmatch Server as  Docker Image","archived":false,"fork":false,"pushed_at":"2024-03-27T15:34:13.000Z","size":5279,"stargazers_count":37,"open_issues_count":3,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-03T18:20:49.000Z","etag":null,"topics":["docker","docker-image","gameserver","goldsrc","half-life","hldm","hlds","steam"],"latest_commit_sha":null,"homepage":"","language":"Pawn","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spezifanta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2018-05-28T21:02:18.000Z","updated_at":"2024-07-10T04:18:36.000Z","dependencies_parsed_at":"2023-03-24T11:20:41.277Z","dependency_job_id":null,"html_url":"https://github.com/spezifanta/hldm-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spezifanta%2Fhldm-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spezifanta%2Fhldm-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spezifanta%2Fhldm-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spezifanta%2Fhldm-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spezifanta","download_url":"https://codeload.github.com/spezifanta/hldm-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224369481,"owners_count":17299901,"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":["docker","docker-image","gameserver","goldsrc","half-life","hldm","hlds","steam"],"created_at":"2024-08-02T18:00:38.256Z","updated_at":"2025-05-03T17:30:53.032Z","avatar_url":"https://github.com/spezifanta.png","language":"Pawn","funding_links":[],"categories":["Gaming"],"sub_categories":["Game Servers - Docker"],"readme":"\n![Half-Life](/media/banner.jpg)\n\n# Half-Life Deathmatch Server as Docker image\n\nProbably the fastest and easiest way to set up an old-school Half-Life Deathmatch Dedicated Server (HLDS).\nYou don't need to know anything about Linux or HLDS to start a server. You just need Docker and this image.\n\n## Quick Start\n\nStart a new server by running:\n```\ndocker run -it --rm -d -p27015:27015 -p27015:27015/udp spezifanta/hldm\n```\n\nChange the player slot size, map or `rcon_password` by running:\n```\ndocker run -it --rm -d --name hldm -p27015:27015 -p27015:27015/udp spezifanta/hldm +map crossfire +maxplayers 12 +rcon_password SECRET_PASSWORD\n```\n\n\u003e **Note:** Any [server config command](http://sr-team.clan.su/K_stat/hlcommandsfull.html) can be passed by using `+`. But it has to follow after the image name `spezifanta/hldm`.\n\n\nThe following default maps are available:\n - boot_camp\n - bounce\n - crossfire\n - datacore\n - frenzy\n - gasworks\n - lambda_bunker\n - rapidcore\n - snark_pit\n - stalkyard\n - subtransit\n - undertow\n\n\n## Advanced\n\nIn order to use a custom content like maps or server config file, create a directory named `gamedir` and place your files there.\nFor an example of a custom `server.cfg` run:\n\n```\nmkdir gamedir \u0026\u0026 echo 'echo \"Executing custom server.cfg\"' \u003e gamedir/server.cfg\n```\n\nAdd your settings to the `server.cfg` and mount the directory as volume by running:\n\n```\ndocker run -it --rm -d -p27015:27015 -p27015:27015/udp -v gamedir:/tmp/gamedir spezifanta/hldm\n```\n\nYou should see `Executing custom server.cfg` in the server log when starting the server.\n\n\n## About this Docker image\n\nThis image uses the latest version of [Half-life](https://store.steampowered.com/app/70/HalfLife), which can be installed via [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD)\nand patched versions of:\n\n - [Metamod v1.20](http://metamod.org/)\n - [Stripper2 v1.0.0](http://hpb-bot.bots-united.com/stripper2.html)\n\n Patches: https://github.com/spezifanta/metamod-p\n\n\n## But why?\n\n### Speed\n\nSetting up a new HLDS from scratch can be a bit tedious because since a few years now SteamCMD will fail to download all the files on the first try.\nThe general workaround is just by retrying. And retrying, and retrying, and... :gun:. A more promising workaround is replacing certain files and forcing a redownload. But even this can fail sometimes.\nAnyway, just searching for the download link of SteamCMD takes longer than just copying \u0026 pasting the Docker `run` command from above (yes, this assumes you have Docker installed. But why haven't you already?).\n\nAlso, there are a couple of server commands, which need tweaking, and plugins, that need to be installed and configured.\n\n\nSo this image saves a lot of time.\n\n\n### Sustainability\n\nHalf-Life is more than 20 years old now. Many major community pages and tutorials are offline. I am not saying, that Half-Life will die, but the sites with the step by step instructions, workarounds and plugins might not be around for ever.\nFurthermore not everybody, who likes playing Half-Life and wants to set up a server, is a Linux geek. You don't need to know anything about Linux or HLDS to start a server by using this image.\nThat's why I build this image.\n\nI want HLDM to live forever!\n\n\n### Other reasons\n\n- In most cases, you have to wrap `hlds_run` anyway by using something like `screen`, `tmux`, `wmux` or `systemd`, because the server will exit as soon as you close your terminal. So why not add Docker to that list.\n- Decoupling. To set up a HLDS you need to install 32bit libraries. On a 64bit system, this is somewhat less than perfect. On a company PC, you might need extra permissions to do so. With Docker on the other hand... I hope you get my point ;).\n- Scalability.\n\n\n## License\n\nMIT\n\n## Test Server\n\nConnect to `steamcalculator.com:27015` to give it a try.\n\n\u003ca href=\"https://www.youtube.com/watch?v=y15dfBZSx9Q\" target=\"_blank\"\u003e\n\u003cimg src=\"/media/github-video.jpg\" alt=\"HLDM Docker\"/\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspezifanta%2Fhldm-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspezifanta%2Fhldm-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspezifanta%2Fhldm-docker/lists"}