Knowledge Base

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:

  1. Log in to the Customer Portal.
    If you do not know how to log in to the Customer Portal, please see this article.
  2. On the Services menu, click My Services.
  3. In the list of services, locate the WHMCS License entry, and then click the Manage button.
  4. In the left column, under Overview, click the Downloads link.
  5. Available downlods are displayed in the right column. Click the Download button for the desired version and save it.
  6. The download file is a .zip archive containing all the files needed to install WHMCS.
  7. Log in to Plesk.
    If you do not know how to log in to your Plesk account, please see this article.
  8. In the Plesk control panel, select the domain where WHMCS will be installed.
  9. In the administration area for the selected domain, click the File Manager icon:

  10. The File Manager opens with the httpdocs directory selected. The httpdocs directory is the root directory of the selected domain.
  11. On the menu bar at the top of File Manager, click the Upload button. A File Upload dialog box is displayed.
  12. In the File Upload dialog box, navigate to the location where the WHMCS file was saved.
  13. Select the file by clicking on it, and then click the Open button.
  14. 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:

    Click the uploaded archive to extract the files.

  15. 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 OK button.
  16. The extraction process creates a new directory named whmcs that contains the WHMCS files.
  17. 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.
  18. 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:

    Click the whmcs foilder.

  19. 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 Rename:

    Click rename in the flyout menu.

  20. The Rename dialog box is displayed. Change the name of the file to configuration.php, and then click the OK button:

    Rename configuration.php.new to configuration.php

Step 2: Create a database

To create a MySQL database to use with WHMCS, follow these steps:

  1. From the File Manager, return to the administration panel by clicking the domain name at the top of the screen:

  2. On the administration panel, click the Databases icon located at the upper right of the administration panel:

    Click the Databases icon.

  3. On the Databases page, click the Add Database button.
  4. On the following page, type a database name, a database username, and a password for the database user. Click Allow local connections only:

    View of database creation screen.

    Make a note of the database name, username, and password. You will need this information later in the installation process.
  5. To finish the database creation, click the OK button.

Step 3: Set the PHP version

To create a MySQL database to use with WHMCS, follow these steps:

  1. From the Databases page, return to the administration panel by clicking the domain name at the top of the screen:

  2. On the administration panel, click the PHP Settings icon:

    Click the PHP Settings icon.

  3. On the PHP Settings page, select PHP version 7.0.xx (where xx is any minor version number) from the PHP version list box:

    Select version 7.0.xx from the list box.

  4. At the bottom of the page, click the OK button. 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:

  1. 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.
  2. On the initial page, review the End User License Agreement, and then click I Agree if you want to proceed.
  3. On the next page, look for the System Requirements Check Passed notice. If the system meets the necessary requirements, click the Begin Installation button.
  4. 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.
  5. On the next page, complete the fields to set up the administrator account, and then click the Complete Setup button.
  6. 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:

  1. In Plesk, return to the File Manager, and then navigate to the folder where WHMCS is installed.
  2. Click the check box to the left of the installation directory, and then click the Remove 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:

  1. On the administration panel, click the Scheduled Tasks icon located at the upper right:

    Scheduled Tasfs icon.

  2. On the Scheduled Tasks page, click the Add Task button.
  3. On the Schedule a Task page, click Run a PHP script:

    Radio buttons for task type.

  4. 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 OK 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:

    Script path text box.

  5. In the Use PHP version list box, select the same PHP version selected for the installation in Step 3: Set the PHP version:

    Select PHP version from the list.

  6. In the Run list box, select Cron style.
  7. 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:

    Configure the schedule for the task.

    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.
  8. In the Description text box, type a descriptive name for the task:

    Description text box.

  9. Notifications can be configured for various results of the scheduled task.
  10. To create the scheduled task, click the OK button.

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:

  1. In the administration panel for the selected domain, click the File Manager icon.
  2. Navigate to the folder where WHMCS is installed.
  3. In the right-hand pane, scroll down until the configuration.php file is visible.
  4. Click the list box at the far right where configuration.php is displayed, and then click Change Permissions.
  5. 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:

    Icon for Application pool group user.

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

    Checkbox for write permission.

  7. To complete the permissions changes, click the OK button.

More Information

For more information about WHMCS, please visit https://www.whmcs.com.