How to Manually Install WHMCS via cPanel
WHMCS is one of the most popular billing and automation platforms used by web hosting companies. It helps manage clients, invoices, support tickets, and automation of hosting services. In this guide, we will walk through the manual installation of WHMCS via cPanel, including uploading the ZIP file, extracting it, creating a database, assigning privileges, and completing the installation through the browser.
This method is commonly used when auto-installers like Softaculous are not available.
Requirements Before Installation
Before starting, make sure you have the following:
-
A working hosting account with cPanel access
-
WHMCS ZIP file (downloaded from official WHMCS site)
-
Domain name pointed to your hosting server
-
PHP version compatible with your WHMCS version
-
MySQL/MariaDB support enabled
Step 1: Upload WHMCS ZIP File in cPanel
-
Log in to your cPanel account.
-
Go to File Manager.

3. Open the directory where you want to install WHMCS:
-
Usually:
public_html/(for main domain) -
Or a subfolder like
public_html/billing/

4. Click Upload from the top menu.

5. Select the whmcs.zip file from your computer and upload it.
Once uploaded, you will see the ZIP file in the directory.

Step 2: Extract WHMCS Files
-
Select the uploaded
whmcs.zipfile. -
choose Extract.

3. Confirm the extraction path (same folder is recommended). Click Extract files

4. After extraction, you will see WHMCS files and folders such as:
-
/admin -
/clientarea -
/includes -
/templates
Important: If files are inside a subfolder (like whmcs/), move them to the correct directory (e.g., public_html) so your domain loads properly.
Step 3: Create MySQL Database in cPanel
WHMCS requires a database to store all data like clients, invoices, and settings.
-
Go to cPanel → Databases → Manage My Databases

2. Under “Create New Database”, enter a name (example: whmcs_db)
3. Click Create Database

Step 4: Create Database User
-
Scroll to MySQL Users section
-
Create a new user:
-
Username:
whmcs_user -
Password: use a strong password
-
-
Click Create User

Step 5: Assign User to Database (Privileges)
This is a very important step.
-
Go to Add User to Database
-
Select:
-
User:
whmcs_user -
Database:
whmcs_db
-
-
Click Add

4. On the privileges screen, select:
- ALL PRIVILEGES
5. Click Make Changes
Now your database is ready for WHMCS installation.

Step 6: Start WHMCS Installation via Browser
Now open your domain in a browser.
Example:
-
https://yourdomain.com/
or -
https://yourdomain.com/billing/(if installed in subfolder)
You will see the WHMCS installation wizard. Click on Click here to begin

Step 7: Pre-Installation Checks
WHMCS will automatically check your server configuration:
-
PHP version compatibility
-
Required PHP extensions
-
File permissions
If everything is green, click on I Agree

- Click on Begin Installation

Step 8: Enter Database Details
Now provide the database information you created earlier:
- License Key
-
Database Name:
whmcs_db -
Database Username:
whmcs_user -
Database Password: (your password)
-
Database Host:
localhost - Database Port
Click Continue.
WHMCS will now connect to the database and initialize tables.

Step 9: Set Admin Account
Next, you need to create the WHMCS admin login:
- First Name
- Last Name
- Email Address: your email
- Admin Username: (choose username)
- Password: (strong password)
- Confirm Password
Click on Complete Setup
This account will be used to manage WHMCS admin panel.

Step 10: Complete Installation
After setup:
-
WHMCS will finalize installation
-
It may ask you to delete the
installfolder (important for security)

3. Go back to File manager and then delete the Install folder

4. You will get login access to admin panel:
- Enter Username and Password
- Click on Login

- You will see the WHMCS Interface

Step 11: Post-Installation Security Steps
After installation, follow these important steps:
-
Delete
/installdirectory -
Set correct file permissions
-
Configure cron job in cPanel
-
Enable SSL (HTTPS) for security
-
Update WHMCS to latest version
Conclusion
Manually installing WHMCS via cPanel is a straightforward process when done step-by-step. It involves uploading the ZIP file, extracting it, setting up a MySQL database with proper privileges, and completing the installation through the browser.
Once installed, WHMCS becomes a powerful automation tool for managing hosting clients, billing, and support efficiently.
If you follow this guide carefully, you can successfully set up WHMCS without needing any auto-installer tools.
