Installation and Setup - Legoman99573/BoNeMEAL GitHub Wiki
BoNeMEAL is a little bit more advanced than other web interfaces for the Ban-Managament plugin. We're implying you know a little bit more about web servers and PCs in general...
Pre-Installation
First of all, be sure you run the latest version of the Ban-Management plugin on your Minecraft server (BoNeMEAL requires the latest database structure).
BoNeMEAL is built upon Laravel for great performance and reliability. The Laravel framework has a few server requirements:
PHP 5.5.9 or higher OpenSSL PHP Extension PDO PHP Extension Mbstring PHP Extension Tokenizer PHP Extension If your webserver is running Apache then mod_rewrite should be installed. If you do not run Apache you will have to find out yourself how to manipulate URLs with your server software.
Please make sure that the directory / sub-directory in which you are installing the application is empty.
- Download
You can download the stable releases of BoNeMEAL for free here at GitHub.
Developing and testing
Alternatively you can download BoNeMEAL including all the latest changes here. You could also use Git to clone the repository on your server and keep it easily updated by using "git pull".
These version are not tested and are primarily intended for users to check if the issue they reported has been fixed successfully.
- Installation
Unzip
Unzip the archive to the prepared directory on your webserver.
Secure
Be sure that nobody (except the app itself) can access the /application directory or any subfolder/files of that application directory. Otherwise the web app will be easily hackable.
By default there is an .htaccess file placed in the /application folder to prevent access to it (on Apache webservers). Be sure that this works on your server. If you use any other webserver software, you have to secure the directory yourself.
Adapt
Check the .htaccess file and set the RewriteBase accordingly before you continue (again: .htaccess files only work on Apache, if you use any other software you will have to find out yourself how to do this). By default we assume you installed BoNeMEAL in a way so it's accessible by navigating to /BoNeMEAL (e.g. http://cool-server.com/BoNeMEAL). If that is the case you should be ready to continue.
Example: set to /bans/index.php for those hosts who don't understand what /bans is by itself.
Grant permission
Be sure your /application/storage directory is readable and writeable. Set the permission to 777 (or 755 with owner as webserver user).
Install
After you are done, navigate to /index.php/install (e.g. http://cool-server.com/BoNeMEAL/index.php/install) to start the install wizard and follow the instructions.
- Setup
Login with the superuser account you have just created and go to Configuration > Servers > Add Server. Fill out the form and make sure the web app can access the MySQL database you have set.