+44 151 528 8706 [email protected]

How to install whmcs.

Like many, you may be handling orders, payments, and clients via spreadsheets, QuickBooks etc. If this sounds familiar to you, then WHMCS may be the solution for you.

The fact that you’re reading this article shows you’re serious about learning, and that’s the first step. Here, we’re going to explain everything you need to know about WHMCS to move forward with your reseller hosting business. First, let’s start with the basics…

What is WHMCS?

WHMCS stands for Web Host Manager Complete Solution. Until it was acquired by cPanel, WHMCS was a privately-owned company based in the UK; their platform was so successful, it blossomed into somewhat of an industry staple. They’re the go-to software that automates all the operations needed for online web hosting and domain registration.

To download WHMCS:

  1. Visit https://download.whmcs.com/
  2. Click Download under the Full Release heading. This will be the latest release version.

Installing Ioncube

WHMCS is encrypted using ionCube Loader® to protect the source code. Most hosting providers compile ionCube support into the PHP build by default.

If you need to install ionCube on your server, see our Ioncube Installation Tutorial.

However, if you’re hosted on a managed server, ionCube should be already installed and running.


Creating a Database

WHMCS uses a MySQL® database to store settings and data. You must create one during the installation process, or create one before you begin. For more information, see our System Environment Guide.

Restrict Database Privileges

Most tasks require the following database privileges:


Installation, upgrades, and activating and deactivating modules require the following additional privileges:

  • DROP

    To install WHMCS, you can use the following process:

    • Unzip the contents of the .zip file to a folder on your computer.
    • Rename the configuration.php.new to configuration.php.
    • Upload the entire whmcs folder to your website. If you experience problems, try uploading the folder in binary mode.
    • Optionally, rename the folder (for example, billing).

      Note: The administration area uses an admin folder. You cannot use admin as the installation folder name.

    • Navigate to the installation script at http://www.yourdomain.com/whmcs/install/install.php to run the installation. If you see an ionCube-related error message, perform the ionCube steps above.
    • Follow the instructions to install WHMCS. This will include setting file permissions (see below), entering your license key, and setting up your primary administrator account.

      When complete, delete the installation folder from your web server and check the configuration.php file permissions again.


      Required file and folder permissions

      /configuration.php CHMOD 400 Readable
      /attachments CHMOD 777 Writable
      /downloads CHMOD 777 Writable
      /templates_c CHMOD 777 Writable

      The directory example permissions above may be overly permissive. I.E. world read/write permission might not be necessary or appropriate for your hosting environment:

      • For suPHP or PHP suEXEC, you will need to restrict directories further. If you use DSO as your PHP handler, you must use 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.

        Installing WHMCS In cPanel

        If you use cPanel, you can also install WHMCS directly from within the interface. To do this:

        1. Check whether your hosting provider has installed WHMCS using the WHM Site Software feature. For more information, see Configuring WHMCS in cPanel Site Software.
        2. Log in to cPanel and click the Site Software icon.
        3. Click WHMCS.
        4. Select the domain where you want to install WHMCS.
        5. Click Install.
        6. The installation may take up to 30 seconds. After it finishes, you will see a success message, a link to the login page, and automatically-generated default login credentials.
        7. Visit the provided link to log in for the first time.
        8. Upon logging in for the first time, the interface will prompt you to review and agree to the End User License Agreement.
        9. The interface will prompt you to activate WHMCS. To do this, enter an existing WHMCS license key if you already have one, or follow the link to purchase a new license.
        10. After entering your license key, click Activate to validate and complete the process.

        WHMCS is now installed and ready to use.


        Post Installation Suggested Steps

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

        1. Perform the recommended Further Security Steps.
        2. Log in to the Admin Area and configure your general settings (Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings).
        3. Set up your payment gateways (Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Payment Gateways).
        4. Set up your products and services (Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products and Services).
        5. Configure your domain pricing (Configuration () > System Settings > Domain Pricing or, prior to WHMCS 8.0, Setup > Domain Pricing).
        6. Set up your support ticket departments (Configuration () > System Settings > Support Departments or, prior to WHMCS 8.0, Setup > Support Departments).
        7. Set up email piping so you can manage tickets using the WHMCS Support Desk. For more information, see Email Piping.
        8. Make sure that the WHMCS cron job is set up and configure automated tasks (Configuration () > System Settings > Automation Settings or, prior to WHMCS 8.0, Setup > Automation Settings).
        9. Place some test orders on your website to check your setup.

          Need help installing whmcs on your server? Getoutsourced has you covered with a professional team. [Contact us]

How to Mount an NFS Share in Linux

Network File System (NFS) is a distributed file system protocol that allows you to share remote directories over a network. With NFS, you can mount...

How to install Plesk on CentOS

Plesk is a commercial web hosting and server data center automation software with a control panel developed for Linux and Windows-based retail hosting...

Plesk vs cPanel

When choosing between web hosting control panels, it’s often a toss-up between Plesk or cPanel. Between them, they dominate the market for users looking for account and server...

We're Here To Help!

3 + 8 =

Head Office

Ukshin Kovaçica, 10,000 Pristina, Republic of Kosovo

Call Us

+44 151 528 8706