Installation

bPass comes with a built-in web installer that automatically guides you through the complete setup process. Once you upload the application files and visit your domain, the installer will handle database configuration, email settings, and all necessary components.

Server Requirements

Before installation, ensure your server meets these minimum requirements:

• Web Server: Apache 2.4+ or Nginx 1.18+
• PHP: Version 8.2 or higher
• Database: MySQL 8.0+ or MariaDB 10.4+
• SSL Certificate: Required for Web Crypto API functionality
• Required PHP Extensions: xml, pdo, pdo_mysql, OpenSSL, Mbstring, Tokenizer, Ctype, Fileinfo, Imagick, JSON, BCMath, Curl, Zip

SSL Certificate Required

bPass requires HTTPS to function properly. The Web Crypto API, which is essential for secure password encryption and management, only works over secure connections. Make sure to install an SSL certificate before using the application.

Choose Your Installation Method

Select the guide that matches your hosting environment:

📱 cPanel Hosting

Recommended for beginners - Shared hosting with cPanel control panel - Most popular hosting option - Step-by-step GUI-based setup

🔧 Cloud Server - LAMP Stack

For Apache users - Ubuntu/Debian servers with Apache - Full server control and customization - Includes SSL and performance optimization

⚡ Cloud Server - LEMP Stack

For high performance - Ubuntu/Debian servers with Nginx - Better performance and resource efficiency - Advanced caching and optimization

Quick Start

1. Download the application package
2. Upload application.zip to your server
3. Extract files to your web directory
4. Visit your domain - you'll be redirected to /install
5. Follow the web installer steps

Important

Make sure your domain points to the public directory of the Laravel application, not the application root directory.