hlds

GitHub Actions Workflow Status Codacy Badge

Half-Life Docker logo

About

Automated builder of Docker images for Half-Life Dedicated Server (HLDS).

DepotsDownloader is used to download HLDS. It has advantages over SteamCMD, has a minimum of dependencies, easy installation, doesn’t have the issues that SteamCMD users are experiencing.

The base image is Debian.

Images

Image Tags Pulls Image size
HLDS valve public, steam_legacy Docker Pulls Docker Image Size
HLDS cstrike public, steam_legacy Docker Pulls Docker Image Size
HLDS czero public, steam_legacy Docker Pulls Docker Image Size
HLDS dod public Docker Pulls Docker Image Size
HLDS gearbox public Docker Pulls Docker Image Size
HLDS tfc public Docker Pulls Docker Image Size
HLDS ricochet public Docker Pulls Docker Image Size
HLDS dmc public Docker Pulls Docker Image Size

Tags

Name Description
public Latest depots update
steam_legacy Pre-25th Anniversary Build

How it works

At 00:00 on Sunday using GitHub Actions, all images are automatically rebuilt and published to Docker Hub (https://hub.docker.com/u/hldsdocker).

The description for Docker Hub repositories (of each mod) is dynamically generated using CI from the template.

Technical Definitions

Depots

A depot is a logical grouping of files which are all delivered to a customer as a single group.

Content files URL
Base Goldsrc Shared Content https://steamdb.info/depot/1/
Counter-Strike Base Content https://steamdb.info/depot/11/
Condition Zero Base Content https://steamdb.info/depot/81/

Read more about depots in Steamworks documentation.

Branches

An application can have multiple branches. Other than the “public” branch, there can be other branches. Other branches are often used for storing an older version of the game for people to downgrade to, or for testing new patches/content. These can often be found in the “Betas” tab in the app’s properties in the Steam client. Some branches might require a password, and they won’t be visible in the drop-down list until the correct password is entered.

A list of possible branches and depots can be found here:

Game Depots link
valve https://steamdb.info/app/70/depots/
cstrike https://steamdb.info/app/10/depots/
сzero https://steamdb.info/app/80/depots/

Read more about branches in Steamworks documentation.

Secrets and Variables for GitHub Actions

Type Key Description
Variable DOCKER_USERNAME DockerHub user account
Secret DOCKER_PASSWORD DockerHub user password

Read more about secrets and variables in GitHub Docs.