Deploy Quake 4 Game Servers

Install Dependencies Using LinuxGSM

LinuxGSM will attempt to install dependencies either by having the q4server user account with sudo access or running the installer as root.

user with sudo access

During the installation if the game server user has sudo permissions LinuxGSM will attempt to install any missing dependencies itself.

root user

if q4server is already installed run ./q4server install as root and LinuxGSM will automatically install missing dependencies.

Install

From the command-line do the following. Ensuring you have also installed the required dependencies.

1. Create a user and login.

adduser q4server

For security best practice, ensure you set a strong password. Random password:

su - q4server

2. Download linuxgsm.sh.

curl -Lo linuxgsm.sh https://linuxgsm.sh && chmod +x linuxgsm.sh && bash linuxgsm.sh q4server

3. Add Steam login details.

You will need to enter a Steam username and password to download dedicated server.

It is recommended that you create a new Steam username just for the server.

nano lgsm/config-lgsm/q4server/common.cfg

steamuser="username"
steampass='password'

4. Run the installer following the on-screen instructions.

./q4server install

Basic Usage

All Commands

A complete list of commands can be found by typing.

./q4server

Below are the most common commands available.

Running

start

./q4server start

stop

./q4server stop

restart

./q4server restart

console

Console allows you to view the live console of a server as it is running and allow you to enter commands; if supported.

./q4server console

To exit the console press CTRL+b d. Pressing CTRL+c will terminate the server.

Updating

update

Update checks for any server updates and applies them. The server will update and restart only if required.

./q4server update

Bypass the check and go straight to SteamCMD update.

./q4server force-update

validate

You can use the SteamCMD validate option when updating the server.

./q4server validate

Debugging

Details

You can get all important and useful details about the server such as passwords, ports, config files etc.

./q4server details

Debug

Use debug mode to help you if you are having issues with the server. Debug allows you to see the output of the server directly to your terminal allowing you to diagnose any problems the server might be having.

./q4server debug

Logs

Server logs are available to monitor and diagnose your server. Script, console and game server (if available) logs are created for the server.

/home/q4server/logs

Backup

Backup will allow you to create a complete tar bzip2 archive of the whole server.

./q4server backup

Monitor

LinuxGSM can monitor the game server by checking that the proccess is running and querying it. Should the server go offline LinuxGSM can restart the server and send you an alert. You can use cronjobs to setup monitoring.

./q4server monitor

Configure LinuxGSM

For details on how to alter LinuxGSM settings visit LinuxGSM Config Files page.

Documentation

For detailed documentation visit the LinuxGSM docs.

Cronjobs

To automate LinuxGSM you can set scheduled tasks using cronjobs, to run any command at any given time. You can edit the crontab using the following.

crontab -e

Below are the recommended cron tasks.

*/5 * * * * /home/q4server/q4server monitor > /dev/null 2>&1
*/30 * * * * /home/q4server/q4server update > /dev/null 2>&1
0 0 * * 0 /home/q4server/q4server update-lgsm > /dev/null 2>&1

Configure LinuxGSM

For details on how to alter LinuxGSM settings visit LinuxGSM Config Files page.

Documentation

For detailed documentation visit the LinuxGSM docs.