Difference between revisions of "Installing WHMCS"

From WHMCS Documentation

(Downloading WHMCS)
Line 16: Line 16:
  
 
[[File:Videotutorial.png‎|center|link=http://www.youtube.com/watch?v=7gANkXcOBoc&hd=1|Watch Video Tutorial]]
 
[[File:Videotutorial.png‎|center|link=http://www.youtube.com/watch?v=7gANkXcOBoc&hd=1|Watch Video Tutorial]]
 
  
 
Installing WHMCS is very simple.  The following steps will guide you through the process:
 
Installing WHMCS is very simple.  The following steps will guide you through the process:
Line 28: Line 27:
 
#When complete, delete the install folder from your web server and CHMOD the configuration.php file back to 644.
 
#When complete, delete the install folder from your web server and CHMOD the configuration.php file back to 644.
  
Required file & folders permissions (unless your php is suPHP or PHPSuExec):
+
<div class="docs-alert-warning">
+
<span class="title">Required file & folders permissions</span><br /><br />
/configuration.php          CHMOD 644 Writeable
+
/configuration.php          CHMOD 400 Readable<br />
/attachments                CHMOD 777 Writeable
+
/attachments                CHMOD 777 Writeable<br />
/downloads                  CHMOD 777 Writeable
+
/downloads                  CHMOD 777 Writeable<br />
/templates_c                CHMOD 777 Writeable
+
/templates_c                CHMOD 777 Writeable<br /><br />
/configuration.php                CHMOD 400 READABLE*
+
The above applies unless your php is suPHP or PHPSuExec. If using DSO as your php handler, you must use 644 permissions.
*If using DSO as your php handler, you must use 644 permissions.
+
</div>
  
 
==Post Installation Suggested Steps==
 
==Post Installation Suggested Steps==
Line 50: Line 49:
 
#Place some test orders on your website to check everything works as expected
 
#Place some test orders on your website to check everything works as expected
  
 +
[[File:Videotutorial.png‎|center|link=https://www.whmcs.com/get-support/video-tutorials/|Watch Video Tutorial]]
  
[[File:Videotutorial.png‎|center|link=https://www.whmcs.com/get-support/video-tutorials/|Watch Video Tutorial]]
 
 
For further guidance, you can watch video tutorials we have prepared for the above tasks @ [https://www.whmcs.com/get-support/video-tutorials/ www.whmcs.com/get-support/video-tutorials/]
 
For further guidance, you can watch video tutorials we have prepared for the above tasks @ [https://www.whmcs.com/get-support/video-tutorials/ www.whmcs.com/get-support/video-tutorials/]

Revision as of 09:36, 19 May 2014

Downloading WHMCS

  1. Visit http://download.whmcs.com/
  2. Click the Download button under the Full Release heading - this will be the latest release version

Reseller Customers
If your license key was obtained via a reseller and you therefore do not have a login for our members area, your reseller will be able to provide the latest WHMCS files to you

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

Installing WHMCS

Watch Video Tutorial

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

  1. Unzip the contents of the zip file to a folder on your computer
  2. Rename the file configuration.php.new to configuration.php
  3. Upload the entire whmcs folder to your website - if you experience problems, try uploading in binary mode
  4. Next you can rename the folder to whatever you like (billing, clients, etc...)
  5. 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
  6. 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
  7. When complete, delete the install folder from your web server and CHMOD the configuration.php file back to 644.

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. If using DSO as your php handler, you must use 644 permissions.

Post Installation Suggested Steps

After installation is completed, we recommend that you go through and configure your new WHMCS system in the following order:

  1. Login to the Admin Area and configure your General Settings (Setup > General Settings)
  2. Setup your Payment Gateways (Setup > Payment Gateways)
  3. Setup your Products & Services (Setup > Products and Services)
  4. Configure your Domain Pricing (Setup > Domain Pricing)
  5. Setup your Support Ticket Departments (Setup > Support Departments)
  6. Setup email piping so you can manage tickets using the WHMCS Support Desk - for full instructions on this please see the Email Piping article
  7. Ensure the WHMCS Cron Job is setup and configure automated tasks (Setup > Automation Settings)
  8. Place some test orders on your website to check everything works as expected
Watch Video Tutorial

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