Installation

Prepare the panel host, run the web installer, then connect remote agents.

GSE runs as a Linux-hosted PHP panel backed by MySQL or MariaDB, with separate agents installed on game-host machines. Install the known web-server baseline first, then use check.php to verify the host before running the installer.

PHP >= 8.3Ubuntu 24.04 baselineApache rewrite supportMySQL or MariaDB

Panel host baseline

Install dependencies before running the web installer.

The dependency checker is a verification step after installing this baseline. Do not rely on it as the primary way to discover missing packages.

Ubuntu 24.04 packages

Copy and run this on the panel web server:

sudo apt update
sudo apt install apache2 mysql-client unzip tar screen sudo subversion git rsync \
    php8.3 php8.3-mysql php8.3-gd php8.3-curl php8.3-mbstring php8.3-zip \
    php8.3-xml php8.3-xmlrpc php-pear libapache2-mod-php8.3 -y
sudo a2enmod rewrite
sudo systemctl restart apache2

Database placement

The panel needs MySQL or MariaDB access. The baseline installs mysql-client for remote or existing database servers.

If the database server is local to the panel host, also run:

sudo apt install mariadb-server -y

Install flow

Deploy the panel into the intended document root or subdirectory, then open check.php to verify PHP, extensions, commands, rewrite support, and writable install paths.

After verification, run install.php. Use the gsp_ database prefix unless a deliberate compatibility plan says otherwise.

Checker mapping

What the baseline satisfies.

These are the web-server requirements checked by the panel dependency page.

PHP extensions and libraries

  • mysqli - php8.3-mysql
  • curl - php8.3-curl
  • gd - php8.3-gd
  • mbstring - php8.3-mbstring
  • zip - php8.3-zip
  • xml - php8.3-xml
  • xmlrpc - php8.3-xmlrpc
  • PEAR - php-pear

Commands and Apache

  • mysql command - mysql-client
  • Linux commands - unzip, tar, screen, sudo, subversion, git, and rsync
  • Apache rewrite - apache2 plus sudo a2enmod rewrite

Runtime checks

json, openssl, fileinfo, and session are normally included by Ubuntu PHP runtime packages, but check.php still verifies them.

Writable install paths include includes, modules, upload, cache, log, temp, and includes/config.inc.php.