Difference between revisions of "Installing WHMCS"

Revision as of 17:45, 28 April 2020

Downloading WHMCS

Reseller Customers
If you obtained your license key from a reseller and you don't have a login for our members area, your reseller can provide the latest WHMCS files to you.

To download WHMCS:

Visit http://download.whmcs.com/
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 do need to install ionCube on your server, see our Ioncube Installation Tutorial.

Creating a Database

WHMCS uses a MySQL database to store all settings and data. You will be asked to create one during the installation process, so best to create one beforehand. Technical information is detailed on the Database Setup page.

Restrict Database Privileges

For day to day use, only the following database privileges are required. All others may be disabled.

DELETE
INSERT
SELECT
UPDATE
LOCK TABLES

Please note that installation, upgrading, activating, and deactivating modules require the following additional privileges.

ALTER
CREATE
DROP
INDEX

Installing WHMCS

Installing WHMCS is very simple. The following steps will guide you through the process:

Unzip the contents of the zip file to a folder on your computer
Rename the file configuration.php.new to configuration.php
Upload the entire whmcs folder to your website - if you experience problems, try uploading in binary mode
Next you can rename the folder if desired (billing, clients, etc...)

Note: The folder name "admin" is reserved for the administration area, so cannot be used as the installation directory name here

Now visit the installation script at http://www.yourdomain.com/whmcs/install/install.php to run the installer process - if you get an Ioncube related error message, see the installation Ioncube steps above
Follow the instructions on screen to install which will involve setting file permissions as listed below, entering your license key and setting up your primary admin account

When complete, delete the install folder from your web server and ensure the configuration.php file permissions are restricted.

Required file & folders permissions

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

The above applies unless your php is suPHP or PHPSuExec, in which case you directories should be more restrictive. If using DSO as your php handler, you must use 644 permissions. It is important that permissions are limited to only the account that owns the web server process and that no other system accounts can read your configuration file or modify any files related to WHMCS.

Advanced users can also perform this process on the command line.

Installing WHMCS In cPanel

Check with your server administrator or hosting provider that WHMCS has been installed using the Site Software feature of WHM. For more information, please see: https://help.whmcs.com/m/installation/l/1027775-configuring-whmcs-in-cpanel-site-software
Login to cPanel and click the Site Software icon
Click the WHMCS link
Select the desired domain for the WHMCS application to be installed to:
Click Install
The installation may take up to 30 seconds and once completed, you will see a success confirmation along with a link to the login page and automatically generated default login credentials.
Visit the administration URL via the link provided to login for the first time.
Upon logging in for the first time, you will be asked to review and agree to the End User License Agreement.
You will subsequently be asked to activate WHMCS. This can be done either by entering an existing WHMCS license key if you already have one, or by following the link to purchase a new license.
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 installation is completed, we recommend that you go through and configure your new WHMCS system in the following order:

Perform the recommended Further Security Steps
Login to the Admin Area and configure your General Settings (Setup > General Settings)
Setup your Payment Gateways (Setup > Payment Gateways)
Setup your Products & Services (Setup > Products and Services)
Configure your Domain Pricing (Setup > Domain Pricing)
Setup your Support Ticket Departments (Setup > Support Departments)
Setup email piping so you can manage tickets using the WHMCS Support Desk - for full instructions on this please see the Email Piping article
Ensure the WHMCS Cron Job is setup and configure automated tasks (Setup > Automation Settings)
Place some test orders on your website to check everything works as expected

For further guidance, you can watch video tutorials we have prepared for the above tasks @ www.whmcs.com/get-support/video-tutorials/

@@ Line 12: / Line 12: @@
 ==Installing Ioncube==
-WHMCS is encrypted using Ioncube to protect the source code.  These days most servers/webhosts have Ioncube support compiled into the PHP build by default so you don't normally need to do anything extra for it.  However if you find you do need to install Ioncube on your server, then you can find out how to do this in our [[Ioncube Installation Tutorial]]
+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 do need to install ionCube on your server, see our [[Ioncube Installation Tutorial]].
 ==Creating a Database==

Documentation