Back to all templates
phpBB logo

phpBB

Application256MB+ RAM

Classic open-source forum software

forumphpcommunitybulletin-board

Deploy phpBB in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select phpBB

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy phpBB on a VPS with Server Compass

Use the phpBB template in Server Compass to deploy a self-hosted open-source forum software with persistent phpBB application and MySQL volumes on your VPS, then verify the phpBB web UI in a browser.

About 7 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a phpBB app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for phpBB

Use the template picker search to find phpBB in the Server Compass template catalog.

Searching for phpBB in the Server Compass template picker
4
Step 4

Select the phpBB template

Choose the phpBB template. Server Compass fills the phpBB image, host port, published server URL, and persistent phpBB application and MySQL volumes.

phpBB template selected in Server Compass
5
Step 5

Review the phpBB settings

Confirm the app name and compose services. In this run, the app was named phpbb-demo and used host port 8080.

Reviewing phpBB project settings and compose services
6
Step 6

Deploy phpBB

Review the generated environment values, confirm the port is available, and click Deploy Now.

Reviewing phpBB environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the phpBB image, starts the container, and verifies the stack.

Server Compass deploying the phpBB template on the VPS
8
Step 8

Confirm phpBB is running

After deployment finishes, return to the Apps tab and confirm the phpBB app is marked Running with its application URL available.

phpBB template running in the Server Compass Apps tab
9
Step 9

Open phpBB in the browser

Open the application URL in a browser. The phpBB web UI confirms the site is reachable.

The deployed phpBB web UI loaded in a browser

After phpBB Opens

  • Complete the phpBB installer, create the administrator account, then remove or protect the installer before production use.
  • Configure board settings, permissions, email, HTTPS, and user registration before inviting users.
  • Add a domain and HTTPS before exposing the forum to users.
  • Back up the phpBB and MySQL volumes before relying on the forum for production communities.

Verified Result

The phpBB web UI loaded successfully in a browser.

phpBB deployment questions

What does the phpBB template deploy?

It deploys phpBB with MySQL plus persistent application and database volumes.

Which port did the tutorial use?

The tutorial used host port 8080, which maps to the phpBB web server on container port 80.

Why does the guide stop at the first-run web UI?

The tutorial verifies the clean first-run web UI because real library paths, users, metadata providers, and remote access settings depend on the production server.

Should this become a blog post?

No. The deployment guide should live on the phpBB template detail page and be linked from the reusable template deployment docs page.

Manual Deployment Guide

Manual phpBB Setup

For terminal enthusiasts: deploy phpBB manually with these simple steps.

1

Access Your VPS via Terminal

Open a terminal session and log into your VPS. Replace the placeholder with your actual IP.

terminal
# Connect via SSH
ssh root@your-vps-ip

# Alternative with key file
ssh -i /path/to/key root@your-vps-ip

First time? Make sure Docker is installed on your VPS. Run: curl -fsSL https://get.docker.com | sh

2

Set Up Project Folder

Create a workspace for your deployment files.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/phpbb
cd ~/apps/phpbb
3

Create the Compose File

Configure your containers with this Docker Compose setup:

docker-compose.yml
services:
  phpbb:
    image: php:8.2-apache
    ports:
      - "8080:80"
    environment:
      - PHPBB_DB_HOST=db
      - PHPBB_DB_NAME=phpbb
      - PHPBB_DB_USER=phpbb
      - PHPBB_DB_PASSWORD=<your-db-password>
    volumes:
      - phpbb_data:/var/www/html
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    command: >
      bash -c "
        docker-php-ext-install mysqli pdo pdo_mysql > /dev/null 2>&1;
        if [ ! -f /var/www/html/index.php ]; then
          curl -sL https://download.phpbb.com/pub/release/3.3/3.3.14/phpBB-3.3.14.zip -o /tmp/phpbb.zip &&
          apt-get update -qq && apt-get install -y -qq unzip > /dev/null 2>&1 &&
          unzip -q /tmp/phpbb.zip -d /tmp/phpbb &&
          cp -r /tmp/phpbb/phpBB3/* /var/www/html/ &&
          chown -R www-data:www-data /var/www/html &&
          chmod -R 755 /var/www/html &&
          rm -rf /tmp/phpbb /tmp/phpbb.zip;
        fi;
        apache2-foreground
      "

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=<your-db-root-password>
      - MYSQL_DATABASE=phpbb
      - MYSQL_USER=phpbb
      - MYSQL_PASSWORD=<your-db-password>
    volumes:
      - db_data:/var/lib/mysql
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -p$$MYSQL_ROOT_PASSWORD || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

volumes:
  phpbb_data:
  db_data:
Environment Configuration
PORTHost port to expose(default: 8080)
DB_NAMEDatabase name(default: phpbb)
DB_USERDatabase user(default: phpbb)
DB_PASSWORDDatabase password
DB_ROOT_PASSWORDRoot password
4

Deploy Your Stack

Spin up the containers and verify the deployment.

terminal
# Start all services
docker compose up -d

# List running containers
docker compose ps

# Watch the logs
docker compose logs -f
5

Update Firewall Settings

Allow incoming traffic on the application port.

terminal
# Allow the application port through firewall
sudo ufw allow 8080/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:8080
Skip the Terminal

Skip the terminal. Use Server Compass instead.

Deploy phpBB without touching the command line. Server Compass gives you a clean UI for one-click deployments.

  • Beautiful interface
  • One-click deploys
  • Let's Encrypt SSL
  • Zero downtime
  • Container monitoring
  • Easy rollbacks
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying phpBB with Server Compass, complete these steps to finish setup

1

Run the installation wizard at /install

2

Configure database (use host db, port 3306)

3

Create admin account

4

Remove install directory

Need help? Check out our documentation for detailed guides.

phpBB FAQ

Common questions about self-hosting phpBB

How do I deploy phpBB with Server Compass?

Simply download Server Compass, connect to your VPS, and select phpBB from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for phpBB?

phpBB requires a minimum of 256MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing phpBB data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard phpBB backup and restore procedures.

How do I update phpBB to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest phpBB image will be pulled and deployed with zero downtime.

Is phpBB free to self-host?

phpBB is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host phpBB?

Download Server Compass and deploy phpBB to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass