> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://wiki.volthosting.co.uk/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to install WHMCS on cPanel

This guide will show you how to install WHMCS onto the VoltHosting cPanel website hosting service. You will need a WHMCS license, and cPanel website hosting before proceeding, so please purchase one from us beforehand.

| Looking for a WHMCS license? Take a look at our [official WHMCS licenses](https://billing.volthosting.co.uk/index.php?rp=/store/licenses) which we sell for cheaper than if bought directly from WHMCS!

Follow the steps below to install WHMCS onto your cPanel service. 

There are two ways you can install WHMCS on cPanel. You can install it manually (recommended for customisability) or you can use our software installer.

* [Installing WHMCS Manually](#1-installing-whmcs-manually)
* [Installing WHMCS via the software installer](#1-installing-whmcs-using-our-software-installer)

---
# Installing WHMCS manually

1. Purchase a [WHMCS license](https://billing.volthosting.co.uk/index.php?rp=/store/licenses) from VoltHosting, and have the key to hand.
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/1vx0dzyibepgmrujbamv8auv8pmlgn_13g1nvi.png)
2. Head to the [VoltHosting client area, and download the latest version of WHMCS](https://billing.volthosting.co.uk/index.php?rp=/download/category/3/WHMCS.html) .

![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/yaeghwfnt1ehgzanvpdfxama41l1np_9zc3rm.png)ake sure to select the latest version of WHMCS

3. Install the required PHP modules and use the correct PHP version in line with the [WHMCS system requirements](https://docs.whmcs.com/getting-started/system-requirements/) .

4.  [Head over to cPanel](https://vh-cp02.volthosting.co.uk:2083/) , and then under `Software`, select `Select PHP Version` .
| If you don't know how to login, take a look at our [logging into cPanel guide](https://volthosting.crisp.help/en/article/logging-in-to-cpanel-t631gj/) .
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/akvs8px6a7y9ydaanpa7ceaxblec0y_nsechi.png)
5. Then under `Extensions` make sure your version of PHP is the latest version listed on the official [WHMCS system requirements](https://docs.whmcs.com/getting-started/system-requirements/) . Then, enable `ioncube_loader` .

![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/mrrbql0liqji35fm0tn2dhdz3kwdwf_95ds5a.png)
6. Once PHP is setup correctly, you need to create the WHMCS database. 
7. Head over to cPanel, then under `Databases` select `Database Wizard` .
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/ogt5olwqqjcgoi0vcekewcsmovfc46_1cqk3m7.png), enter in the database name. For example, `whmcs`, and then click `Next` .
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/tm7nixya4hd8npv0qkout51xb8byn0_125xo6n.png)ur database name is INCLUDING the prefix of your account username, in the examples case this is `volthosting` but this will be different for you.

9. Now, the user needs to be created. Enter in the systems username and create a password, then click `Next` .
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/n04mugfrmascpltvv4pd4tp1p3axhf_p7kd86.png)s example we used the username `whmcs` .

|| Your database username is INCLUDING the prefix of your account username, in the examples case this is `volthosting` but this will be different for you.

10. Now you need to assign the database permissions to the user. WHMCS needs the permissions below:



| ALTER | DROP | LOCK TABLES |
| CREATE | INDEX | SELECT |
| DELETE | INSERT | UPDATE |
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/9scypqhjlprpatk7jmaqik2w4zbprz_1871yu2.png)
|| For daily operations, you can restrict WHMCS’s database by removing the ALTER, CREATE, DROP, and INDEX privileges. WHMCS only requires these privileges for installations, updates, and activating or deactivating modules.

11. Click `Make Changes` and then `Next Step` . 

12. Now, upload your WHMCS files to the server. 
13. Go to cPanel, then under `Files`, select `File Manager` .
14. Navigate to the directory that you want WHMCS installed to. In most cases, you will want this on the root of your domain, which will likely be the `public_html`  directory.
15. Now, click `Upload` and select the downloaded `.zip` file which contains the WHMCS files.
16. When the upload finishes, click `Go Back` and you'll see the new `.zip` in the directory.
17. Right click on the `.zip` and click `extract` and select the wanted destination, then click `Extract files` . 

18. Now, you can finish the WHMCS installation using your browser. 
Head over to the installation script at the following address:
 
```
https://www.example.com/whmcs/install/install.php
```
 
| Please replace `example.com` with your domain used on cPanel

19. Follow the instructions on screen. You will need to accept the EULA, enter your WHMCS license, and create a admin account.

20. Once you have finished the installation process in the browser, you will see a `Installation Completion` page appear. You now need to delete the WHMCS installation folder.
Using the same steps as before, head to the directory you installed WHMCS in, and find a folder called `install`, then right click on the folder, and click `delete`.

21. Finally, you need to check the file folders and permissions.
Check to ensure that you are using the correct permissions for WHMCS’s configuration file ( `configuration.php` ) and the `attachments`, `downloads`, and `templates_c` directories. WHMCS will not function correctly if they do not use the correct permissions.

WHMCS requires the following file and folder permissions for most installations:

* `/configuration.php` — `CHMOD 400` (Readable)
* `/attachments` — `CHMOD 777` (Writable)
* `/downloads` — `CHMOD 777` (Writable)
* `/templates_c` — `CHMOD 777` (Writable)

You may need to adjust these permissions to suit your environment. For example, if you use suPHP or suEXEC, you may need to restrict directory access further. DSO requires `644` permissions.

Limit access to only the account that owns the web server process. Make sure that no other system or user accounts can read your configuration file or modify any WHMCS-related files.

22. You're done! WHMCS is now installed. 

After you complete installation, we recommend that you configure WHMCS in the following order:

1. Perform our recommended additional steps to [enhance your installation’s security](https://docs.whmcs.com/getting-started/configuring-whmcs/enhancing-security) .
2. Configure your installation’s [general settings](https://docs.whmcs.com/system/general-settings) .
3. Set up your [payment gateways](https://docs.whmcs.com/admins/apps-and-integrations) .
4. Set up your [products to sell](https://docs.whmcs.com/products/products) .
5. Configure your [domain pricing](https://docs.whmcs.com/domains/pricing-and-configuration/domain-pricing) .
6. Set up your [support ticket departments](https://docs.whmcs.com/support/support-departments) .
7. Set up [email piping](https://docs.whmcs.com/support/email-piping) or [email importing](https://docs.whmcs.com/support/email-importing) to manage email replies to support tickets.
8. Create and configure the [WHMCS cron job](https://docs.whmcs.com/system/automation/system-cron) and its [automated task settings](https://docs.whmcs.com/system/automation/automation-settings) .
9. Place some [test orders](https://docs.whmcs.com/getting-started/installing-whmcs/set-up-a-test-environment) on your website.

---

# Installing WHMCS using our software installer

1. Purchase a [WHMCS license](https://docs.whmcs.com/getting-started/installing-whmcs/install-whmcs/) from VoltHosting, and have the key to hand.

![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/1vx0dzyibepgmrujbamv8auv8pmlgn_1lqylml.png)
2. Install the required PHP modules and use the correct PHP version in line with the [WHMCS system requirements](https://docs.whmcs.com/getting-started/system-requirements/) .
3. [Head over to cPanel](https://vh-cp02.volthosting.co.uk:2083/) , and then under `Software`, select `Select PHP Version`.

|| If you don't know how to login, take a look at our logging into cPanel guide.

![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/akvs8px6a7y9ydaanpa7ceaxblec0y_e41n16.png)

4. Then under `Extensions` make sure your version of PHP is the latest version listed on the official [WHMCS system requirements](https://docs.whmcs.com/getting-started/system-requirements/) . Then, enable `ioncube_loader`.
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/mrrbql0liqji35fm0tn2dhdz3kwdwf_1lupsln.png)
5. Now you can utilse the software installer. On cPanel, head to `Software`, and then `App Installer` 
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/zqrnndp2ewm1wgdkvgnrgtxxqkoypr_1iykc3w.png)
6. Locate WHMCS on the page, and click `Install` .
![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/joiuilfzgkjolzdo6rh3io5htmiryg_18tmza9.png)
7. On this page, fill out all the information on the page. 
You should fill out: 
* The domain
* The installation directory
* Select `HTTPS` 
* Set the admin login details
* Select the latest version of WHMCS
* Put in the company name
* Enter in the license key

||| THIS IS NOT AN EXAUSTIVE LIST, PLEASE DOUBLE CHECK THE PAGE TO ENSURE ALL THE INFORMATION IS CORRECT!

![](https://storage.crisp.chat/users/helpdesk/website/a7f74f9f83d47000/mudthpnkegkwuqyxdrodaglfrykqgp_1c3x9lf.png)

8. Once you **ARE SURE** that all information is correct. Click `Quick Install` .

9. Wait for the installation to finish, and then you're done! WHMCS is now installed. 
