Dedicated server guide

Action Half-Life

Manage ahlserver with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Operator-provided prerequisites required · Support evidence: 2026-10-16.

Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

27015/UDP, 27015/TCP, clientport/UDP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Mods and plugins

No mod support is declared in this snapshot; review the game guide before adding mods.

Backup hook

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Choose a supported runtime

Linux and Docker quickstart

Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-ahlserver create ahlserver
Complete interactive setup ./alphagsm-docker my-ahlserver setup
Start the game server ./alphagsm-docker my-ahlserver start
Check the instance status ./alphagsm-docker my-ahlserver status

./alphagsm-docker start
./alphagsm-docker my-ahlserver create ahlserver
./alphagsm-docker my-ahlserver setup
./alphagsm-docker my-ahlserver start
./alphagsm-docker my-ahlserver status

Host process

Create the game instance ./alphagsm my-ahlserver create ahlserver
Complete interactive setup ./alphagsm my-ahlserver setup
Check the host prerequisites ./alphagsm my-ahlserver doctor
Start the game server ./alphagsm my-ahlserver start
Check the instance status ./alphagsm my-ahlserver status

./alphagsm my-ahlserver create ahlserver
./alphagsm my-ahlserver setup
./alphagsm my-ahlserver doctor
./alphagsm my-ahlserver start
./alphagsm my-ahlserver status

This guide covers the ahlserver module in AlphaGSM.

ahlserver is currently ENABLED (BYO) on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane still exercises both process and Docker runtime selection around that owned-mod-content prerequisite, while local runs remain process-backed by default unless you opt into the Docker backend.

query and info use A2S.

Requirements

screen
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myahlserve create ahlserver

Run setup:

alphagsm myahlserve setup

ahlserver is supported in ENABLED (BYO) mode. AlphaGSM can install the base HLDS runtime through SteamCMD, but Steam app 90 does not provide the Action Half-Life mod payload. Before start, copy a complete owned Action Half-Life content tree into <install_dir>/action/ so <install_dir>/action/maps/ahl_hydro.bsp exists.

Start it:

alphagsm myahlserve start

Check it:

alphagsm myahlserve status

Stop it:

alphagsm myahlserve stop

Setup Details

Setup configures:

the game port (default 27015)
the install directory
the executable name
SteamCMD downloads the server files
default configuration and backup settings

Suggested flow:

alphagsm myahlserve create ahlserver
alphagsm myahlserve setup -n 27015 /path/to/ahlserver
## copy the full Action Half-Life mod tree into /path/to/ahlserver/action/
alphagsm myahlserve start

Useful Commands

alphagsm myahlserve update
alphagsm myahlserve backup

Notes

Module name: ahlserver
Default port: 27015

Server variables

After create ahlserver, inspect or change these with set:

alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE

Key	Aliases	Type	What it does
`map`	gamemap, startmap, level, worldname	string	The currently selected map or level. Example: `ahl_hydro`.
`maxplayers`	users	integer	Maximum number of player slots. Example: `16`.
`port`	gameport	integer	The primary game port. Example: `27015`.
`rconpassword`	rconpass, querypassword, query_administrator_password	string	Remote console password for administrative access. Stored as a secret.
`servername`	hostname, name	string	The server's public name shown to players. Example: `AlphaGSM Action Half-Life`.
`serverpassword`	sv_password, password	string	Password required for players to join the server. Stored as a secret.

Developer Notes

Run File

Executable: hlds_run
Location: <install_dir>/hlds_run
Engine: GoldSrc (HLDS)
SteamCMD App ID: 90
Mod App ID: cstrike

Server Configuration

Config file: action/server.cfg
Key settings:
- hostname — Server name
- sv_maxrate — Max network rate
- rcon_password — Remote console password
Default port: 27015
Default map: ahl_hydro
Max players: 16
Ports:
- Game port: 27015 (UDP)
- Client port: 27005 (UDP)
Template: See server-templates/ahlserver/

Maps and Mods

Map directory: action/maps/
Mod directory: action/dlls/
Workshop support: No
Map install: Copy .bsp files into action/maps/ and add to action/mapcycle.txt.
Mod install: Use Metamod in action/dlls/ or AMX Mod X in action/addons/amxmodx/.

BYO file helper

Inspect this game's required files, source instructions and destinations with alphagsm <server-name> assets requirements; check the declared files with alphagsm <server-name> assets check. File checks do not establish game readiness. This helper checks known sentinels only and directs you to stage the complete compatible distribution manually; managed import is unavailable for this recipe. See BYO files and private SteamCMD acquisition.

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

server.cfg

Share your server

Sector Alpha server directory

When your server is ready, you can publish its connection details and community information on Sector Alpha. Review your listing and keep the information current.

Find a community

Browse the directory for game servers and their published connection details.

Browse server directory

Publish your server

Prepare a name, address and description for your listing.

Publish a server

Manual server sharing instructions

Frequently asked questions

What support evidence is recorded for Action Half-Life?

Operator-provided prerequisites required. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Which runtimes can run Action Half-Life?

Declared runtimes: Docker or a Linux host process.

Which ports does Action Half-Life use?

27015/UDP, 27015/TCP, clientport/UDP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Can I add mods to Action Half-Life?

No mod support is declared in this snapshot; review the game guide before adding mods.

How should I back up Action Half-Life?

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Source and support evidence

This guide mirrors AlphaGSM’s upstream documentation at 32cef5ba9e03053c8e461fffa0ba133b160b528d. Commands and prerequisites can change. Check current support notes before installation.

All game guides