Linux Agent installation

Install the execution engine on Debian or Ubuntu game hosts.

The Linux Agent receives signed Panel requests, starts and monitors game servers, runs installer jobs, and reports logs and status back to the Panel.

apt/dpkg automationdefault port 12679systemd service/home/gameserver/GSP

Prerequisites

Use the repository script on apt/dpkg systems only.

The current prerequisite installer exits on hosts without apt-get and dpkg. Do not treat it as support for unrelated distributions.

Run prerequisites

chmod +x install_agent_prereqs.sh install.sh agent_conf.sh gsp_agent_run
sudo ./install_agent_prereqs.sh

The script must run as root and installs package-manager prerequisites for Debian/Ubuntu.

Required packages

The script installs Perl, XML and archive Perl modules, Frontier RPC, file-copy and scheduler modules, screen, rsync, sudo, e2fsprogs, unzip, subversion, git, curl, ca-certificates, pure-ftpd, and libc6.

Optional packages

The script attempts libdbi-perl, libdbd-mysql-perl, libfcgi-perl, apache2, php, and php-mysql as optional packages. Failures are warnings.

It can also enable i386 and install 32-bit compatibility packages for legacy SteamCMD or game binaries.

Guided install

Configure the agent with the same key used by the Panel.

The installer copies repository files, preserves existing config files, creates runtime directories, writes config through agent_conf.sh, and can install a systemd service.

Run installer

sudo ./install.sh

Options include --install-dir, --agent-user, --service-name, --no-service, and --no-prereqs.

Defaults

  • install directory: /home/gameserver/GSP
  • agent user: gameserver
  • systemd service: gsp_agent
  • listen IP: 0.0.0.0
  • listen port: 12679

Safety checks

The installer refuses unsafe install paths under core system directories such as /, /etc, /usr, /var, and /root.

If the agent user does not exist, the installer asks before creating it.

Configuration

Agent config is local runtime state.

Do not overwrite generated config files during updates. The installer intentionally excludes existing config files when copying into the install directory.

Files written

  • Cfg/Config.pm: log path, listen IP and port, version, shared key, Panel URLs, remote server ID, stats settings.
  • Cfg/Preferences.pm: screen logs, FTP mode, restart behavior, port validation settings.
  • Cfg/bash_prefs.cfg: restart-time update settings and FTP bind settings.

Runtime directories

The installer creates logs, tmp, screenlogs, runtime_status, events, and _gsp_content runtime folders.

Service commands

sudo systemctl status gsp_agent
sudo journalctl -u gsp_agent -f
sudo systemctl restart gsp_agent
tail -f /home/gameserver/GSP/gsp_agent.log

Panel handoff

Finish by opening the agent port and adding the remote server.

The Linux Agent installation is not complete until the Panel can reach the configured agent listener.

Firewall

Open the configured agent TCP port, usually 12679, from the Panel host. Also open game-specific ports before provisioning game servers.

Panel remote server

In the Panel, create or edit the remote server using the agent listen IP or hostname, listen port, and exact key from Cfg/Config.pm.

Manual config rerun

./agent_conf.sh --guided --install-dir /home/gameserver/GSP --agent-user gameserver

Use this when the Panel URL, key, or remote server ID changes.