V2Board Dockerized Deployment with PHP-FPM + Nginx + Supervisor#

Running a scalable, production-ready Laravel-based app like V2Board requires more than just PHP — it demands orchestration. This Dockerized stack offers a lightweight, secure, and feature-rich environment using PHP 8.2 (FPM), Nginx, Redis, MariaDB, and Supervisor — all running on Alpine Linux.

🔍 About V2Board#

V2Board is a modern, feature-rich open-source subscription management panel designed for proxy services like Shadowsocks, V2Ray, and Trojan.

It provides a complete billing and user dashboard solution for ISPs, resellers, and privacy-focused network providers.

✨ Key Features:#

🧾 Subscription Billing System (plans, pricing, and orders)
🌐 Multi-protocol Support (V2Ray, Shadowsocks, Trojan)
👥 User Management (self-registration, usage stats, invite system)
💳 Integrated Payment Gateways (Alipay, Stripe, etc.)
📈 Traffic Monitoring (user stats, server stats, real-time)
🌍 Multi-language UI with clean frontend
🔌 Node Management (connect multiple backend nodes easily)

V2Board is actively developed and widely used in privacy and VPN-related hosting environments. It’s written in PHP + Laravel, making it easy to customize and scale.

📦 Stack Features#

🐳 PHP 8.2 FPM with Laravel + V2Board
🔁 Supervisor-managed services (PHP-FPM, Nginx, Laravel Scheduler)
⚙️ Composer pre-installed and ready
🔄 Auto-run Laravel schedule:run loop
🧰 Pre-bundled extensions: pdo_mysql, redis, gd, imagick, intl, soap, bcmath, and more
🔐 Secure Alpine base running as www-data
🧠 Auto v2board:install if .env is missing

⚙️ Docker Compose Setup#

services:
  web:
    image: ghcr.io/nooblk-98/v2board-docker:latest
    container_name: v2board
    environment:
      ADMIN_MAIL: [email protected]
      ADMIN_PASSWORD: admin@123+
    ports:
      - "8080:80"
    depends_on:
      - mariadb
      - redis
    volumes:
      - web_data:/var/www/html

  mariadb:
    image: mariadb:10
    container_name: mariadb
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: v2board123+
      MYSQL_DATABASE: v2board
      MYSQL_USER: v2boarduser
      MYSQL_PASSWORD: "v2boarduser123"
    volumes:
      - db_data:/var/lib/mysql
    ports:
      - "3306:3306"

  redis:
    image: redis:latest
    container_name: redis

volumes:
  db_data:
  web_data:

🌐 Deployment Guide#

🛠 : Update Enviroment Variables in Compose#

      ADMIN_MAIL: [email protected]
      ADMIN_PASSWORD: admin@123+

    environment:
      MYSQL_ROOT_PASSWORD: v2board123+
      MYSQL_DATABASE: v2board
      MYSQL_USER: v2boarduser
      MYSQL_PASSWORD: "v2boarduser123"

🛠 : Start the Stack#

docker compose up -d

🛠 : Fix Permissions (optional)#

If Laravel cannot write to storage/ or bootstrap/cache, run:

docker exec -u root v2board chown -R www-data:www-data /var/www/html

🌐 Step 3: Access the Web UI#

http://localhost:8080

🔐 Admin Credentials#

The admin credentials and the panel link are printed in the logs during first setup.

🧾 Default Credentials:#

Email: [email protected]
Password: admin@123+

These are controlled via environment variables in docker-compose.yml.

Nginx Proxy Manager UI

docker logs v2board | grep -i admin

Example log output:

Admin registered. Email: [email protected], Password: admin@123+
Visit http(s)://your-domain/ff8f4b24 to access the admin panel.

🔁 Replace your-domain with your actual domain or server IP.

🔄 Reset Credentials#

To reset the installation and re-trigger v2board:install:

docker exec -it v2board rm -f /var/www/html/.env
docker restart v2board

🧩 Base Image Details#

Built on ghcr.io/nooblk-98/php-docker-nginx:php82, this image includes:

🧠 PHP 8.2 (FPM) on Alpine Linux
🌐 Nginx pre-configured for /public root
🔁 Supervisor to manage services like scheduler and PHP-FPM
🧰 PHP Extensions:
- pdo_mysql, redis, curl, mbstring, gd, imagick, soap, intl, bcmath, opcache
🚀 Supports both ARM64 (M1/M2) and AMD64 systems