-
Notifications
You must be signed in to change notification settings - Fork 105
Home
The Open Game Panel (OGP) consists of two software packages. The agent manages, controls, and in some cases configures and installs game servers on the actual host server itself. The web portion of OGP is powered by PHP and serves as a secure interface between one or many OGP agents. The OGP web software is a centralized location for server admins, users, and sub-users to stop, start, manage, and edit their game servers across multiple host servers.
OGP Easy Installers - Windows and Linux
OGP Agent Linux Manual Installation Guide
OGP Panel Linux Manual Web Installation Guide
The Open Game Panel agent and web packages can be easily installed on Ubuntu 14.04 and up, Debian, CentOS 6 & 7, and Windows 7 through Windows 10 (including Windows Server versions) using our pre-built easy install packages. You can download and install the easy installers from the OGP Downloads page. There will also be specific instructions on the download page you must follow to use the easy installers. This is the quickest and easiest way to install and use OGP. These installers will configure everything for you required to run both OGP packages (agent and panel) with minimal setup.
If you want to install OGP on Windows, you MUST USE the Windows easy installers (which are pre-configured cygwin packages). If you do NOT use the easy installers for Windows, good luck.
The OGP agent is written in PERL and depends on several software packages. The below guide provides code to install the prerequisites. If any of these software packages are missing, the agent will not work correctly.
All Versions of Ubuntu:
sudo apt-get install libxml-parser-perl libpath-class-perl perl-modules screen rsync sudo e2fsprogs unzip subversion libarchive-extract-perl pure-ftpd libarchive-zip-perl libc6 libgcc1 git curl
sudo apt-get install libc6-i386
sudo apt-get install libgcc1:i386
sudo apt-get install lib32gcc1
sudo apt-get install libhttp-daemon-perl
If sudo is not installed automatically on your installation of Debian, switch to the root user using the below command:
su -
Install sudo now before proceeding:
apt-get install sudo
Add your user to the sudo group if you're not a member of it already (first line for Ubuntu, second line for CentOS / Fedora):
usermod -aG sudo "{REPLACE_WITH_YOUR_LINUX_USERNAME}"
usermod -aG wheel "{REPLACE_WITH_YOUR_LINUX_USERNAME}"
Restart the machine to apply the sudo group change:
shutdown -r now
Now install the prerequisites:
sudo apt-get install libxml-parser-perl libpath-class-perl perl-modules screen rsync sudo e2fsprogs unzip subversion pure-ftpd libarchive-zip-perl libc6 libgcc1 git curl
sudo apt-get install libc6-i386 lib32gcc1
sudo apt-get install libhttp-daemon-perl
Debian 8, 9, and 10 Extra Packages:
sudo apt-get install libarchive-extract-perl
CentOS 6:
sudo yum -y update
sudo yum -y install epel-release wget subversion git
sudo yum install -y perl-libwww-perl proftpd proftpd-utils perl-ExtUtils-MakeMaker glibc.i686 glibc libgcc_s.so.1 perl-IO-Compress-Bzip2 perl-Archive-Extract perl-Archive-Zip perl-Archive-Tar perl-Path-Class
After installation has been completed, you'll need to run the following to get proftpd to work properly:
sudo sed -i "s/^LoadModule\( \)*mod_auth_file.c/#LoadModule mod_auth_file.c/g" "/etc/proftpd.conf"
sudo service proftpd restart
CentOS 7:
sudo yum -y update
sudo yum -y install epel-release wget subversion git
sudo yum install -y perl-HTTP-Daemon perl-LWP-Protocol-http10 proftpd proftpd-utils perl-ExtUtils-MakeMaker glibc.i686 glibc libgcc_s.so.1 perl-IO-Compress-Bzip2 perl-Archive-Extract perl-Archive-Zip perl-Archive-Tar perl-Path-Class
The OGP agent will work with the proper PERL prerequisites on any Linux operating system. This guide only contains instructions for the most post popular Linux flavors. If you manage to setup OGP on a different operating system, please let us know so we can include it in this guide.
There are OLD instructions here for other operating systems including Gentoo and OpenSUSE.
The latest OGP agent files can be downloaded here.
It is recommended that the OGP agent run under its own sudo user account. To create a new user and add him to the sudo group, run this command:
sudo adduser ogpbot
sudo usermod -a -G sudo ogpbot
Extract the agent files to any directory. Then run install.sh with sudo:
sudo bash ./install.sh
Follow the installation prompts, and you're done. The installer should add the appropriate rc links so that the agent will automatically start on boot. Be sure to record and save your agent encryption password somewhere. This is a key that the panel uses to communicate securely. The panel web software will ask for it when configuring servers, so don't lose this information. The encryption can always be retrieved or changed in the Config.pm file located in the /Cfg directory where the OGP agent files were installed.
A working LAMP (Linux Apache MySQL PHP) stack server is required before you can install the OGP web software. If you don't have one already setup and configured, install the dependent packages below. If you do already have a LAMP stack server setup, please verify that you have all of the prerequisite packages listed below. Install any you might be missing.
The below web server packages need to be installed before you can run the OGP web installer.
Note: MySQL can and should be replaced with MariaDB (the package name is usually mariadb-server) if desired
For Ubuntu 14.04 or Lower:
sudo apt-get install apache2 curl subversion php5 php5-gd php5-xmlrpc php5-curl php5-mysql php-pear phpmyadmin mysql-server libapache2-mod-php5 git
For Ubuntu 16.04:
sudo apt-get install apache2 curl subversion php7.0 php7.0-gd php7.0-zip libapache2-mod-php7.0 php7.0-curl php7.0-mysql php7.0-xmlrpc php-pear phpmyadmin mysql-server php7.0-mbstring php-gettext git php-bcmath
For Ubuntu 18.04:
sudo apt-get install apache2 curl subversion php7.2 php7.2-gd php7.2-zip libapache2-mod-php7.2 php7.2-curl php7.2-mysql php7.2-xmlrpc php-pear phpmyadmin mysql-server php7.2-mbstring php-gettext git php-bcmath
If you are running Debian 10 or lower, first make sure you have sudo installed and your user has sudo access.
You can install and configure sudo by switching to the root user account using the command below:
su -
Now install the sudo package:
apt-get install sudo
Add your user to the sudo group if you're not a member of it already:
usermod -aG sudo "{REPLACE_WITH_YOUR_LINUX_USERNAME}"
Restart the machine to apply the sudo group change:
shutdown -r now
Then, run the following commands in a terminal:
For Debian 10 Only:
sudo apt-get install apache2 curl subversion php7.3 php7.3-gd php7.3-zip libapache2-mod-php7.3 php7.3-curl php7.3-mysql php7.3-xmlrpc php-pear mariadb-server php7.3-mbstring php-gettext git php-bcmath
sudo apt-get install phpmyadmin
The second line above used to install phpmyadmin may fail. It's just there as a placeholder for when Debian 10 adds phpmyadmin to its repository of available software to install. phpmyadmin isn't required to run the OGP web panel software. phpmyadmin is just useful and easy to use software.
For Debian 9 Only:
sudo apt-get install apache2 curl subversion php7.0 php7.0-gd php7.0-zip libapache2-mod-php7.0 php7.0-curl php7.0-mysql php7.0-xmlrpc php-pear phpmyadmin mysql-server php7.0-mbstring php-gettext git php-bcmath
For Debian 8 or Lower:
sudo apt-get install apache2 curl subversion php5 php5-gd php5-xmlrpc php5-curl php5-mysql php-pear phpmyadmin mysql-server libapache2-mod-php5 git
Debian 7 Change Default Apache Root Directory:
If you're running Debian 7, it is recommended you change your DocumentRoot to /var/www/html by running these commands (OPTIONAL do NOT do this if you host other websites or have pre-configured your webserver for a custom setup):
sudo sed -i 's#<Directory /var/www.*#<Directory /var/www/html/>#g' /etc/apache2/sites-available/default
sudo sed -i 's#DocumentRoot /var/www.*#DocumentRoot /var/www/html#g' /etc/apache2/sites-available/default
sudo sed -i 's#<Directory /var/www.*#<Directory /var/www/html/>#g' /etc/apache2/sites-available/default-ssl
sudo sed -i 's#DocumentRoot /var/www.*#DocumentRoot /var/www/html#g' /etc/apache2/sites-enabled/000-default
sudo sed -i 's#<Directory /var/www.*#<Directory /var/www/html/>#g' /etc/apache2/sites-enabled/000-default
sudo sed -i 's#DocumentRoot /var/www.*#DocumentRoot /var/www/html#g' /etc/apache2/sites-enabled/000-default
sudo service apache2 restart
This would mean you should place the OGP files in this directory or in a subdirectory within the /var/www/html path.
CentOS 6:
sudo yum -y install epel-release wget subversion git
sudo yum -y install mysql-server
sudo service mysqld restart
sudo mysql_secure_installation
sudo chkconfig mysqld on
sudo yum -y install httpd php php-xmlrpc php-xml php-mysql php-gd php-pear php-mbstring curl
CentOS 7:
sudo yum -y install epel-release wget subversion git
sudo yum -y install mariadb-server
sudo service mariadb restart
sudo mysql_secure_installation
sudo yum -y install httpd php php-xmlrpc php-xml php-mysql php-gd php-pear php-mbstring curl
For other operating systems, please check the OLD instructions here.
The latest OGP web files can be downloaded here.
To install the OGP web software, first create a new MySQL database and assign a MySQL user secured with a password to it.
Then, extract the PHP files to a directory within your Apache2 httpdocs default home directory. Access the installer by visiting http://yourip/yourogpfolderwithfiles in your browser.
Provide the MySQL credentials, create an admin account, and follow the installation steps to complete the install process.
Once the installation is completed, under the "Administration" tab, click on "Servers". Enter in the agent information here. Once the agent has been configured, you can add game servers to it.
Please read the posts in the OGP Important Information forum for other tidbits of information, guides, and documentation.
For help installing OGP, please visit and post in our forums.
You can also request new features, help with new game server XML configuration files, and chat about anything OGP related!
- Game Config
- Game Key
- Query Protocol
- LGSL Query Name
- GameQ Query Name
- Installer
- Game Name
- Server Executable Name
- Query Port
- CLI Template
- CLI Parameters
- Reserve Ports
- CLI Allowed Characters
- Maps Location
- Map List
- Console Log
- Executable Location
- Max User Amount
- Control Protocol
- Mods
- Replace Texts
- Server Params
- Custom Fields
- List Players Command
- Player Info Regex
- Player Info
- Player Commands
- Pre Install
- Post Install
- Pre Start Commands (Windows)
- Environment Variables (Windows)
- Pre Start Commands (Linux)
- Environment Variables (Linux)
- Locking / Protecting Additional Files
- Configuration Files