How to install WHMCS using the Plesk control panel for Windows
This article describes how to install WHMCS using the Plesk control panel on the Windows operating system.
Step 1: Install the WHMCS files on the server
To install the WHMCS files on the server, follow these steps:
- Log in to the Customer Portal.
If you do not know how to log in to the Customer Portal, please see this article
- On the
menu, click .
- In the list of services, locate the WHMCS License entry, and then click the button.
- In the left column, under Overview, click the Downloads link.
- Available downlods are displayed in the right column. Click the Download button for the desired version and save it.
- The download file is a .zip archive containing all the files needed to install WHMCS.
- Log in to Plesk.
If you do not know how to log in to your Plesk account, please see this article
- In the Plesk control panel, select the domain where WHMCS will be installed.
- In the administration area for the selected domain, click the File Manager icon:
- The File Manager opens with the httpdocs directory selected. The httpdocs directory is the root directory of the selected domain.
- On the menu bar at the top of File Manager, click the File Upload dialog box is displayed. button. A
- In the File Upload dialog box, navigate to the location where the WHMCS file was saved.
- Select the file by clicking on it, and then click the button.
The Uploading Files dialog box displays the progress of the file upload. When the upload is finished, the WHMCS files must be extracted from the archive. To do this, click the file name:
- The Extract Files dialog box is displayed requesting confirmation and offering the option to replace existing files. Because this is a new installation, it is not necessary to replace any existing files. Click the button.
- The extraction process creates a new directory named whmcs that contains the WHMCS files.
- The whmcs directory can be renamed to any desired name, or all of the files can be moved into the document root directory so no subdirectory will appear in the URL. In this article, the whmcs directory name is used.
To continue the setup, click the whmcs directory in the right-hand pane of the File Manager to display the contents of the whmcs directory:
In the right-hand pane of File Manager, scroll down until the configuration.php.new file is visible. Click the drop-down list at the far right of the line where configuration.php.new is displayed, and then click :
The Rename dialog box is displayed. Change the name of the file to configuration.php, and then click the button:
Step 2: Create a database
To create a MySQL database to use with WHMCS, follow these steps:
- From the File Manager, return to the administration panel by clicking the domain name at the top of the screen:
On the administration panel, click the Databases icon located at the upper right of the administration panel:
- On the Databases page, click the button.
On the following page, type a database name, a database username, and a password for the database user. Click Allow local connections only:
Make a note of the database name, username, and password. You will need this information later in the installation process.
- To finish the database creation, click the
Step 3: Set the PHP version
To create a MySQL database to use with WHMCS, follow these steps:
- From the Databases page, return to the administration panel by clicking the domain name at the top of the screen:
On the administration panel, click the PHP Settings icon:
On the PHP Settings page, select PHP version 7.0.xx (where xx is any minor version number) from the PHP version list box:
- At the bottom of the page, click the administration panel is displayed.
Step 4: Complete the web setup
After a database is created, the web setup portion of the installation process can be started. To do this, follow these steps:
- In a browser, open the page http://example.com/whmcs/install/install.php, replacing example.com/whmcs with the domain and path of your installation.
- On the initial page, review the End User License Agreement, and then click
if you want to proceed.
- On the next page, look for the System Requirements Check Passed notice. If the system meets the necessary requirements, click the button.
- On the next page, type the license key and the username, password, and database name of the database created in Step 2: Create a database.
If you purchased the WHMCS license from A2 Hosting, you received an e-mail that contains the license key. Alternatively, you can find the key in the A2 Hosting Customer Portal.
- On the next page, complete the fields to set up the administrator account, and then click the
- The following page shows a few additional tasks to complete the setup.
Step 5: Delete the installation folder
The installation folder must be deleted to enable log in to WHMCS. To do this, follow these steps:
- In Plesk, return to the File Manager, and then navigate to the folder where WHMCS is installed.
- Click the check box to the left of the installation directory, and then click the
button on the File Manager toolbar.
Step 6: Configure the cron job
To configure the cron job (also known as a scheduled task) for WHMCS, follow these steps:
- On the administration panel, click the Scheduled Tasks icon located at the upper right:
- On the Scheduled Tasks page, click the button.
On the Schedule a Task page, click Run a PHP script:
Click the folder icon to the right of the Script path text box. The Script Path dialog box is displayed. Navigate to httpdocs/whmcs/crons/cron.php, and then click the button. Replace whmcs with the path of your installation. The path can also be entered directly into the Script path tet box. The completed entry looks like this:
In the Use PHP version list box, select the same PHP version selected for the installation in Step 3: Set the PHP version:
- In the Run list box, select Cron style.
In the text box that appears automatically to the right of Cron style, type 5,20,35,50 * * * * to run the cron every 15 minutes:
WHMCS recommends that the cron runs every 5 minutes. Shared hosting is limited to a 15 minute minimum interval for crons to run. On VPS and dedicated servers, the cron may be run every 5 minutes.
In the Description text box, type a descriptive name for the task:
- Notifications can be configured for various results of the scheduled task.
- To create the scheduled task, click the
Step 7: Additional security steps
WHMCS recommends increasing the security of your installation by setting various permissions. The following example shows how to make the configuration.php file read-only:
- In the administration panel for the selected domain, click the File Manager icon.
- Navigate to the folder where WHMCS is installed.
- In the right-hand pane, scroll down until the configuration.php file is visible.
- Click the list box at the far right where configuration.php is displayed, and then click Change Permissions.
- The Change Permissions page is displayed. Click the Application pool group user, and then clear the check box at the top of the page next to Allow inheritable permissions:
Click the Application pool group user again, and then clear the Allow checkbox for the Write permission. The Full Control and Modify checkboxes are unchecked automatically:
- To complete the permissions changes, click the
For more information about WHMCS, please visit https://www.whmcs.com.
- A2 Hosting Customer Portal
The A2 Hosting Customer Portal is your one-stop shop for managing account billing, payment methods, support tickets, and more. Learn how to use it with these articles.
- Ordering a WHMCS license
Learn how to order a WHMCS license for your reseller hosting package.