Webinterface installation

PunishControl Webinterface Installation

Requirements

• Apache2 web server on a dedicated server or webspace. .htaccess files must be enabled and allowed
  • We have also successfully installed the web interface on a LiteSpeed web server.
  • Microsoft IIS is specifically not supported, but if someone were to translate the htaccess config files, it'd probbably work.
• A MySQL compatible database like MariaDB able to be used with PHP MySQLi and have the MySQLi Native Driver enabled
• PHP 7.3 or higher
• You must be using the plugin with a database (Can be changed if you don't already)

Installation Steps

Linux

• If you have console access (Not the Minecraft Console) Sometimes also called SSH access
  • Go to the folder you would like to install the web interface in
  • Your webserver files are usually located at /var/www/html
  • If you would like to use a subfolder, i.e. example.com/subfolder, create one.
  • Download the latest installer into this directory. (use cd foldername) and the following command to download it: wget https://punishcontrol-source.simplixsoft.com/installer.php.txt && mv installer.php.txt installer.php && sudo chown -R www-data .
  • Open the installer in your webbrowser and follow the given instructions.
• If you don't have console access
  • Download the latest installer from https://punishcontrol-source.simplixsoft.com/installer.php.txt
  • Rename it to installer.php
  • Upload it to your webserver into the folder you would like to install it.
  • Be sure to setup all the necessary permissions.
  • Open the installer in your webbrowser and follow the given instructions.

Windows

• If you are using XAMPP
  • Download the latest installer from https://punishcontrol-source.simplixsoft.com/installer.php.txt
  • Rename it to installer.php
  • Move the installer to the folder you would like to install the web interface in
  • Your webserver files are usually located at C:\xampp\htdocs, but you can also find them by opening the XAMPP Control Panel and clicking on the button Explorer.
  • Open the installer in your webbrowser and follow the given instructions.

Localization

Currently, the following languages are supported:

• English (100% Coverage)
• German (100% Coverage)
• French (100% Coverage) by @Bananaa#6666
• Spanish (100% Coverage) by @Angel Avila#0101

Customization

There is a folder called customization. Within this folder you will find a file called overwrite.css. This css file is imported after all proprietary styling, so you can use it to overwrite all styles to your liking.

Troubleshooting

wget: command not found

This means that you have not installed wget. Take a look at this article: https://www.tecmint.com/install-wget-in-linux/

Missing the MySQLi Native Driver

We have helped someone with this problem before facing the issue in a CPanel installation. To fix it, you need to enable the MYSQLi Native Driver. Here are some screenshots:

htaccess file not working

There is this great article: https://www.keycdn.com/support/htaccess-not-working which might help you out. It explains how to troubleshoot htaccess files not working. Here are two quick fixes we have noticed being the source of problems the most:

• The Redirect engine is not turned on. This is a very simple fix: https://stackoverflow.com/a/26324423/7335057
• .htaccess files are not allowed in your vhost. Here is a possible fix as well as more information to research: https://stackoverflow.com/a/63202947/7335057 The keyword you might use to research is: AllowOverride all