Installing on cPanel

cPanel shared hosting is the main target for WHBMP. This is the full path from an empty account to a working install.

1. Pick the PHP version

1. In cPanel open MultiPHP Manager and set the domain to PHP 8.2 or newer (8.3 or 8.4 recommended).
2. Open MultiPHP INI Editor (or Select PHP Version > Options) and check that memory_limit is at least 128M (the usual default) and set max_execution_time to 60 or more.
3. In Select PHP Version > Extensions tick everything listed in Requirements.

2. Create the database

In MySQL Databases:

1. Create a database.
2. Create a database user with a strong password.
3. Add the user to the database with All Privileges. Forgetting this step is the most common reason for "Could not connect".

Write down the full names. cPanel prefixes them with your account name (account_dbname, account_dbuser).

3. Upload and extract

1. Upload the WHBMP zip with File Manager.
2. Extract it into the folder that will hold the application.

For the main domain this is normally public_html. For an add-on domain or subdomain it is the folder you chose when you created it.

4. Document root

The web server must serve the public folder. Two ways:

• Best: extract to /home/ACCOUNT/whbmp and set the domain's document root to /home/ACCOUNT/whbmp/public (cPanel Domains).
• If the root cannot change: extract so the public contents sit in public_html and the rest sits one level above, then edit the two paths in public/index.php so they point at the folder with vendor and bootstrap.

Never leave the folders app, config, database, storage or the .env file inside a web-accessible folder.

5. Run the installer

Open https://your-domain.com/install and follow Installing WHBMP.

6. Cron and SSL

• Add the cron job in Cron Jobs.
• Use SSL/TLS Status to run AutoSSL so the site is served over HTTPS.

7. Check the account's limits

Some hosts disable functions or limit processes. Open System > System Health and Settings > System Information for the result. WHBMP does not need exec or proc_open: without them it backs up the database with its own PHP code instead of mysqldump.

Common cPanel problems