Knowledgebase

How to Manually Install WHMCS via cPanel

  • 0

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

 

  1. Log in to your cPanel account.

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

 

  1. Select the uploaded whmcs.zip file.

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

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

 

  1. Scroll to MySQL Users section

  2. Create a new user:

    • Username: whmcs_user

    • Password: use a strong password

  3. Click Create User

 

 

 

 

Step 5: Assign User to Database (Privileges)

 

This is a very important step.

  1. Go to Add User to Database

  2. Select:

    • User: whmcs_user

    • Database: whmcs_db

  3. 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:

  1. WHMCS will finalize installation

  2. It may ask you to delete the install folder (important for security)

 

 

 

 

 

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

 

 

 

 

  4. You will get login access to admin panel:

https://yourdomain.com/admin

  • 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 /install directory

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


Was this answer helpful?