From Gentoo Wiki
Jump to: navigation, search


phpBB is open-source bulletin board software, an internet forum package using the PHP scripting language.


Before installing phpBB, it is recommended to peruse the configuration options for Apache, MariaDB/MySQL, and PHP as well.

Use flags

USE flags for www-apps/phpBB An open-source PHP-based bulletin board package

ftp Add FTP (File Transfer Protocol) support
gd Add support for media-libs/gd (to generate graphics on the fly)
mssql Add support for Microsoft SQL Server database
mysqli Add support for the improved mySQL libraries
postgres Add support for the postgresql database
vhosts Add support for installing web-based applications into a virtual-hosting environment
zlib Add support for zlib (de)compression

Especially important is to enable PHP support for www-servers/apache by installing dev-lang/php with the apache2 USE-flag, as well as to enable database support via the mysql USE-flag.


root #emerge --ask www-apps/phpBB


Enabling Apache PHP support

With >=app-eselect/eselect-php-0.8.1, the APACHE2_OPTS variable changed to -D PHP instead of -D PHP5. This allows for future major versions to flow smoothly.
FILE /etc/conf.d/apache2Enabling the PHP module

Creating a database

Refer to MySQL/Startup Guide for detailed instructions.

root #/etc/init.d/mysql start
root #mysql -u root -p
mysql> CREATE DATABASE IF NOT EXISTS <database name> DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
mysql> CREATE USER '<username>'@'localhost' IDENTIFIED BY '<password>';
mysql> GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON phpbb.* TO 'phpbb'@'localhost' IDENTIFIED BY '<password>';
mysql> quit

Completing the phpBB install

root #/etc/init.d/apache2 start

Browsing to http://localhost/phpBB (https for SSL installs) should now bring up the phpBB introduction page with overview and install tabs, which will guide through the rest of the installation process (assuming the package is installed under /var/www/localhost/htdocs/phpBB).

The forum will be accessible to administrators only, until the /var/www/localhost/htdocs/phpBB/install directory is removed or renamed (provided that the package lives under /var/www/localhost/htdocs/phpBB.