How to Deploy phpBB on Ubuntu 22.04

Introduction

phpBB (PHP Bulletin Board) is an open-source, scalable, flat forum application designed to improve user interactions and engagement. phpBB provides a platform for users to engage in discussions, share ideas, and securely exchange information in a single web interface. Forums empower users to connect, learn, and grow by enriching their online experience and facilitating meaningful interactions.

This article explains how to deploy phpBB on a Ubuntu 22.04 server and secure the application to host multiple forums.

Prerequisites

Before you begin:

• Deploy a Vultr Ubuntu 22.04 server to use as the production server.
• Deploy a Vultr Managed Database for MySQL to use with phpBB.
• Set Up a new subdomain A record pointing to your server IP address.
• Access the server using SSH as a non-root user with sudo privileges.
• Update the server.
• Install the Apache, MySQL, and PHP (LAMP) stack

Create a phpBB Database

1. Log in to your Vultr Managed Database for MySQL cluster. Replace examplehost.vultrdb.com with your actual host URL.

   CONSOLE

   Copy

   $ mysql -h examplehost.vultrdb.com -P 16751 -u vultradmin -p

   Explain Code

   Powered by Vultr AgentBeta

   Enter your Vultr Managed Database for MySQL password when prompted.

2. Create a new database to use with phpBB. For example, phpbbdb.

   SQL

   Copy

   mysql> CREATE DATABASE phpbbdb;

   Explain Code

   Powered by Vultr AgentBeta

3. Switch to the database.

   SQL

   Copy

   mysql> USE phpbbdb;

   Explain Code

   Powered by Vultr AgentBeta

4. Create a new user MySQL user phpbbuser with a strong password.

   SQL

   Copy

   mysql> CREATE USER 'phpbbuser'@'localhost' IDENTIFIED BY 'securepassword';

   Explain Code

   Powered by Vultr AgentBeta

5. Grant the user full privileges to the phpBB database.

   SQL

   Copy

   mysql> GRANT ALL ON phpbbdb.* to 'phpbbuser'@'localhost';

   Explain Code

   Powered by Vultr AgentBeta

6. Reload the MySQL privileges to apply the new user permissions.

   SQL

   Copy

   mysql> FLUSH PRIVILEGES;

   Explain Code

   Powered by Vultr AgentBeta

7. Exit the MySQL console

   SQL

   Copy

   mysql> EXIT;

   Explain Code

   Powered by Vultr AgentBeta

Install phpBB

1. Install all required PHP modules to use with phpBB.

   CONSOLE

   Copy

   $ sudo apt install php-mysql php-xml php-mbstring -y

   Explain Code

   Powered by Vultr AgentBeta

2. Download the latest phpBB release package using wget and save it as phpbb.zip.

   CONSOLE

   Copy

   $ wget -O phpbb.zip https://download.phpbb.com/pub/release/3.3/3.3.11/phpBB-3.3.11.zip

   Explain Code

   Powered by Vultr AgentBeta

   The above command downloads the phpBB version 3.3.11, visit the releases page to verify the latest version to install on your server.

3. Extract files from the release file using Unzip.

   CONSOLE

   Copy

   $ unzip phpbb.zip

   Explain Code

   Powered by Vultr AgentBeta

4. Move the extracted directory to your web root directory /var/www/html.

   CONSOLE

   Copy

   $ sudo mv phpBB3 /var/www/html/phpbb

   Explain Code

   Powered by Vultr AgentBeta

5. Grant the Apache web server user and group www-data ownership privileges to the directory.

   CONSOLE

   Copy

   $ sudo chown -R www-data:www-data /var/www/html/phpbb

   Explain Code

   Powered by Vultr AgentBeta

6. Set the phpBB directory permissions to 775 to grant the web server full read and write privileges.

   CONSOLE

   Copy

   $ sudo find /var/www/html/phpbb -type d -exec chmod 755 {} \;

   Explain Code

   Powered by Vultr AgentBeta

7. Set the directory file permissions to 644 to enable only read privileges for other users and the web server group.

   CONSOLE

   Copy

   $ sudo find /var/www/html/phpbb -type f -exec chmod 644 {} \;

   Explain Code

   Powered by Vultr AgentBeta

Configure Apache to Serve phpBB Application Files

1. Create a new Apache virtual host configuration file. For example, phpbb.conf.

   CONSOLE

   Copy

   $ sudo nano /etc/apache2/sites-available/phpbb.conf

   Explain Code

   Powered by Vultr AgentBeta

2. Add the following configurations to the file. Replace phpbb.example.com with your actual domain.

   APACHE

   Copy

   <VirtualHost *:80>
       ServerAdmin admin@example.com
       DocumentRoot /var/www/html/phpbb
       ServerName phpbb.example.com
   
   <Directory /var/www/html/phpbb>
       Options FollowSymlinks
       AllowOverride All
       Require all granted
   </Directory>
   
       ErrorLog ${APACHE_LOG_DIR}/phpbb_error.log
       CustomLog ${APACHE_LOG_DIR}/phpbb_access.log combined
   
   </VirtualHost>

   Explain Code

   Powered by Vultr AgentBeta

   Save and close the file.

   The above configuration creates a new phpBB virtual host profile that listens for incoming connections on the HTTP port 80 and serves files from the /var/www/html/phpbb directory.

3. Enable the phpBB virtual host configuration.

   CONSOLE

   Copy

   $ sudo a2ensite phpbb

   Explain Code

   Powered by Vultr AgentBeta

4. Enable the Apache rewrite module to enable phpBB rewrite rules.

   CONSOLE

   Copy

   $ sudo a2enmod rewrite

   Explain Code

   Powered by Vultr AgentBeta

5. Restart the Apache web server to apply the configuration changes.

   CONSOLE

   Copy

   $ sudo systemctl restart apache2

   Explain Code

   Powered by Vultr AgentBeta

Secure phpBB

The Apache web server accepts incoming connections and serves phpBB on the HTTP port 80. By default, Uncomplicated Firewall (UFW) is active on Vultr Ubuntu servers, configure the application to allow all connection requests to the HTTP port 80 and the HTTPS port 443. Follow the sections below to create new firewall rules and generate trusted SSL certificates to use with phpBB.

Set Up UFW Firewall Rules

1. View the UFW status and verify that the application is active.

   CONSOLE

   Copy

   $ sudo ufw status

   Explain Code

   Powered by Vultr AgentBeta

   If you receive a Status: inactive message, allow the SSH port 22 and run the following command to activate UFW.

   CONSOLE

   Copy

   $ sudo ufw allow 22 && sudo ufw enable

   Explain Code

   Powered by Vultr AgentBeta

2. Allow the HTTP port 80 through the firewall.

   CONSOLE

   Copy

   $ sudo ufw allow 80/tcp

   Explain Code

   Powered by Vultr AgentBeta

3. Allow the HTTPS port 443.

   CONSOLE

   Copy

   $ sudo ufw allow 80/tcp

   Explain Code

   Powered by Vultr AgentBeta

4. Reload the UFW table to apply the firewall changes.

   CONSOLE

   Copy

   $ sudo ufw reload

   Explain Code

   Powered by Vultr AgentBeta

5. View the UFW table to verify the firewall changes.

   CONSOLE

   Copy

   $ sudo ufw status

   Explain Code

   Powered by Vultr AgentBeta

   Output:

   Status: active
   
   To                         Action      From
   --                         ------      ----
   22/tcp                     ALLOW       Anywhere                  
   80/tcp                     ALLOW       Anywhere                  
   443/tcp                    ALLOW       Anywhere                  
   22/tcp (v6)                ALLOW       Anywhere (v6)             
   80/tcp (v6)                ALLOW       Anywhere (v6)             
   443/tcp (v6)               ALLOW       Anywhere (v6)             

Generate Trusted Let's Encrypt SSL Certificates

1. Install the Certbot Let's Encrypt client using Snap.

   CONSOLE

   Copy

   $ sudo snap install --classic certbot

   Explain Code

   Powered by Vultr AgentBeta

   Install the Snapd package if it's unavailable on your server.

   CONSOLE

   Copy

   $ sudo apt install snapd -y

   Explain Code

   Powered by Vultr AgentBeta

2. Generate a new SSL certificate for your phpBB domain. Replace phpbb.example.com and admin@example.com with your actual details.

   CONSOLE

   Copy

   $ sudo certbot --apache --redirect -d phpbb.example.com -m username@example.com --agree-tos

   Explain Code

   Powered by Vultr AgentBeta

   When successful, your output should look like the one below:

   Account registered.
   Requesting a certificate for phpbb.example.com
   
   Successfully received certificate.
   Certificate is saved at: /etc/letsencrypt/live/phpbb.example.com/fullchain.pem
   Key is saved at:         /etc/letsencrypt/live/phpbb.example.com/privkey.pem
   This certificate expires on 2024-07-09.
   These files will be updated when the certificate renews.
   Certbot has set up a scheduled task to automatically renew this certificate in the background.
   
   Deploying certificate
   Successfully deployed certificate for phpbb.example.com to /etc/apache2/sites-available/phpbb-le-ssl.conf
   Congratulations! You have successfully enabled HTTPS on https://phpbb.example.com

3. Verify that Certbot auto-renews the SSL certificate upon expiry.

   CONSOLE

   Copy

   $ sudo certbot renew --dry-run

   Explain Code

   Powered by Vultr AgentBeta

   Output:

   Saving debug log to /var/log/letsencrypt/letsencrypt.log
   Processing /etc/letsencrypt/renewal/phpbb.example.com.conf
   
   Account registered.
   Simulating renewal of an existing certificate for phpbb.example.com
   
   Congratulations, all simulated renewals succeeded: 
     /etc/letsencrypt/live/phpbb.example.com/fullchain.pem (success)

Access phpBB

1. Access your phpBB application using a web browser such as Chrome.

   https://phpbb.example.com

   Verify that the phpBB splash screen displays in your browser session.

   

2. Click INSTALL next to the Overview tab to start the application configuration process.

3. Verify the phpBB system requirements and click Install to test your server environment.

   

4. Enter your phpBB administrator username, email address, and password in the respective fields.

5. Click Submit to apply the new platform administrative user changes.

6. Keep MYSQL selected as the database type. Then, enter your Vultr Managed Database for MySQL hostname, port, and the database, user and password you created earlier. Click Submit to apply the database configuration.

   

7. Click Yes to enable the Force server URL settings option and keep https as the server protocol. Verify your phpBB domain value, and click Submit to save the application configurations.

   

8. Click Yes to activate SMTP server options to use with phpBB or keep NO selected to use the application without email settings. Then, click Submit to save changes.

9. Select your forum language, enter a new board title, and a description to identify the forum.

10. Click Submit to save the new forum settings.

    

11. Click Take me to the ACP to finish the configuration process and redirect to the phpBB control panel.

    

12. Navigate to the Forums tab on the main phpBB control panel menu to create a new forum.

    

13. Click Create new forum.

14. Enter your forum name, description, password, style, and posting rules.

15. Verify any advanced options to modify with the forum settings.

    

16. Scroll and click Submit to create the new phpBB forum.

    

17. Set up the user and group permissions and click Add Permissions to save the forum permissions.

18. Click Manage forums on the left navigation menu to verify the new phpBB forum.

    

19. Visit your main phpBB domain to view the public forums and test the application functionalities.

    https://phpbb.example.com

Conclusion

You have deployed phpBB on a Ubuntu 22.04 Vultr cloud server and secured the application for public use. You can create an online community with public or private access to specific forums on the server to serve your target audience. For more information and configuration options, visit the phpBB documentation.