Installing WHMCS
Contents
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 need to install ionCube on your server, see our Ioncube Installation Tutorial.
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 Database Setup.
Restrict Database Privileges
Most tasks require the following database privileges:
- DELETE
- INSERT
- SELECT
- UPDATE
- LOCK TABLES
Installation, upgrades, and activating and deactivating modules require the following additional privileges:
- ALTER
- CREATE
- DROP
- INDEX
Installing WHMCS
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).
- 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 Writeable
/downloads CHMOD 777 Writeable
/templates_c CHMOD 777 Writeable
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 accounts can read your configuration file or modify any WHMCS-related files.
Advanced users can also perform this process on the command line.
Installing WHMCS In cPanel
If you use cPanel, you can also install WHMCS directly from within the interface. To do this:
- Check whether your hosting provider has installed WHMCS using the WHM Site Software feature. For more information, see Configuring WHMCS in cPanel Site Software.
- Log in to cPanel and click the Site Software icon.
- Click WHMCS.
- Select the domain where you want to install WHMCS.
- Click Install.
- 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.
- Visit the provided link to log in for the first time.
- Upon logging in for the first time, the interface will prompt you to review and agree to the End User License Agreement.
- 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.
- 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/