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
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