From MineOS Wiki
Jump to navigation Jump to search

Getting started

You can watch a complete Youtube video walkthrough here.

The following instructions will set up a phpBB3 forum at [ip-address]/forum. If you prefer a different path, be sure to adjust the values accordingly.

Note, this page applies only to MineOS CRUX. Addons are a MineOS CRUX-only functionality. On other MineOS Variants, such as Turnkey, Ubuntu or FreeBSD, will have many similarities, but will ultimately not work with these instructions alone. Proper installation of PhpBB3 should with instructions provided directly by phpbb.

There is an additional wikipage with tips and help with installing PhpBB3 on FreeBSD.

Enable PHP

Enable CGI execution (PHP) in the Hiawatha configuration.

Secure MySQL

Be sure to set the MySQL root password by securing your MySQL installation.

GD library

PhpBB requires an imaging library, such as php-gd, which is available as an addon.

Downloading phpBB3

Download a current version of PhpBB: Download phpBB 3.0.10 (bz2) (~1.5MB)

Creating database and user


Type in the EXISTING root password for MySQL: mysqlrootpass Database name to create in MySQL: phpforum Username for MySQL backend: phpbbuser Set the password for phpbbuser: phpbbpass /usr/bin/mysql -uroot -pmysqlrootpass -e "CREATE DATABASE IF NOT EXISTS phpforum;" /usr/bin/mysql -uroot -pmysqlrootpass -e "CREATE USER 'phpbbuser'@'localhost' IDENTIFIED BY 'phpbbpass';" /usr/bin/mysql -uroot -pmysqlrootpass -e "GRANT ALL ON *.* TO 'phpbbuser'@'localhost' IDENTIFIED BY 'phpbbpass';" /usr/bin/mysql -uroot -pmysqlrootpass -e "FLUSH PRIVILEGES;" </syntaxhighlight>

Note: phpforum, phpbbuser, and phpbbpass can and should be changed to values of your choice. These are used for PhpBB's backend into the database and WILL NOT be used beyond the installation. Also, the above SQL queries are echoed to you for your benefit as they are executed for you (no further action needed in this script).

Completing quick install

  • Open your browser to http://[ip-address]/forum/install/index.php, filling in your server's IP address.
Overview page
Install page
Requirements page (top)
Database page
Database confirmation page
Administrator page
Administrator confirmation page
Configuration confirmation page
Advanced settings page
Create database tables page
Final Stage output
Remove install directory
  • As the page states, the board is inaccessible while the /install directory exists. Remove the directory:
    • rm -rf /var/www/hiawatha/forum/install/
  • Congratulations! PhpBB is set up!