Introduction
How do I install WHMCS?
Procedure
There are two methods of installing WHMCS.
Method 1: Install WHMCS Manually
To install WHMCS manually, perform the following steps:
- Navigate to the Download WHMCS website.
- Enter your license key in the text box and click "Validate and Download." The system will download a
.zip
file that contains the WHMCS files. - Unzip the contents of the
.zip
file to a folder on your computer. - In the WHMCS folder, rename the
configuration.php.new
file toconfiguration.php
. - Upload the WHMCS folder to your website. You may rename the folder if desired.
- Navigate to https://domain.tld/whmcs/install/install.php, where domain.tld represents your domain. If you uploaded the WHMCS files to a directory other than public_html, paste that path after your domain name in the URL.
- Follow the instructions to complete the installation.
- Change the permissions on the directories. To do this, run the following commands:
chmod 400 configuration.php chmod 777 attachments chmod 777 downloads chmod 777 templates_c
- Navigate to the directory where you uploaded WHMCS and delete the
install
directory. - Log in to your WHMCS account with your license key.
Method 2: Install WHMCS as Site Software
To install WHMCS with Site Software, perform the following steps:
Note: The Site Software interface was deprecated in cPanel version 104 and does not appear on Ubuntu servers.
- Sign into WHM as "root" and go to WHM's Home » cPanel »Install cPAddons Site Software and ensure that WHMCS is installed. If not, you can install it by clicking the check-box and clicking on "Update cPAddon Config."
- Navigate to cPanel's Site Software interface ("cPanel » Home » Software » Site Software").
- Under "Automation," click WHMCS.
- Under the "Install" tab, select a domain from the "Installation Domain" menu. The system will check whether the domain has a WHMCS license.
- If the domain owns a license, click "Install."
- If you possess a license for the domain, but the system does not detect it, click "Enter a license manually." Enter your WHMCS license in the "License Key" text box and click Install.
- If the domain does not possess a license, click "Buy License." The system will connect to the cPanel Store so you can buy a license. After your purchase, the cPanel Store will return you to the "Site Software" interface. Then click "Install."
- After the installation completes, the interface will provide a success message, the username, password, and the WHMCS administration URL.
If you need to locate your license key, we've published the following article outlining the process for locating your WHMCS license key:
How To Find your WHMCS license key
For more information on installing WHMCS, please see our documentation below:
https://docs.cpanel.net/knowledge-base/third-party/how-to-purchase-and-install-whmcs/