Getting Started
This guide covers the basics of WHMCS; starting with ordering a licence, downloading the software, installing it and then what to do next. This page aims to provide a brief overview and will signpost you to the relevant sections in our documentation for full details on everything covered.
Contents
Buying a licence
The very first thing to do is buy a licence for the WHMCS software. Simply click the Order Now link on any page of our website. We offer a range of licence options to suit all budgets but they all provide exactly the same software. You can switch between tiers at any time.
We offer a number of great addons to increase the value of WHMCS; from a fully integrated live chat solution, mobile phone apps, to a full project management system. The option to buy some of these addons will be presented during the order process, for more information and to see the full range visit the Addons Page.
Buy a license https://www.whmcs.com/pricing
Downloading the software
Watch the video tutorial for this feature
Once a licence has been purchased, the software can be downloaded from our Members Area:- Click the My Licenses link under the Services menu
- Select one of your active license keys to view the details
- Click the blue Download Now button to download the latest stable release.
- If you chose to purchase any addons which require extra files, their downloads will also appear here. Note: Not all our addons require extra files.
- Save the zip file to your computer.
Download the software: https://www.whmcs.com/members/
Installing the software
Watch the video tutorial for this feature
Next the WHMCS software must be installed on your server. Please check with your server admin/hosting provider that your server meets the System Requirements.
Installing WHMCS is as simple as installing many other web-based scripts (Wordpress, Joomla, phpBB etc). This is a very brief overview of the installation process. More detailed installation instructions are available.
- Upload the WHMCS zip file to your server
- Extract the zip file and move the WHMCS files your desired location (popular directory names include members, clients, secure or billing)
- Create a new MySQL Database and assign a database user to it.
- Visit the installation script at /install/install.php and to run the installer process.
- Follow the on-screen instructions to complete the installation process.
- When complete, delete the install folder from your web server and CHMOD the configuration.php file back to 644.
Detailed installation instructions: Installing WHMCS
Need help with installation? Check our available services.
Further Security Steps
The WHMCS software will contain some sensitive data, and whilst security is always our number one priority, it is sensible to take extra precautions to ensure your server and the software installed upon it is as secure as possible. To that end, we have some suggestions for further securing a WHMCS installation at Further Security Steps.
Detailed Further Security Steps: Further Security Steps
First Login
Watch the video tutorial for this feature
Now the software is fully installed and secured you can start getting things configured. All the set up, configuration and day-to-day administration is done through the administration area. To login, visit the URL at which you installed the software, for example https://www.example.com/whmcs/admin using the username and password created during the installation process.
Upon login you will be see the Admin Summary page; this page provides an overview of all your company operations. At the top of the page are the Income statistics and the Attention Items - these are items requiring your action. The summary page is made up of "Widgets", each staff member can arrange them however they like simply by clicking and dragging. They can be closed by clicking the "-" icon and disabled entirely in the Administrator Role.
Administration Area Documentation: Admin Area
Configuring WHMCS
After installation is completed, we recommend that you go through and configure your new WHMCS system in the following order:
- Log in to the Admin Area and configure Configuration () > System Settings > General Settings.
- Set up your Payment Gateways in Configuration () > System Settings > Payment Gateways.
- Add your servers to WHMCS in Configuration () > System Settings > Products/Services > Servers.
- Set up your products and services in Configuration () > System Settings > Products/Services > Products/Services.
- Enter your domain registrar account details in Configuration () > System Settings > Products/Services > Domain Registrars.
- Configure your Domain Pricing in Configuration () > System Settings > Domain Pricing.
- Set up your Support Ticket Departments in Configuration () > System Settings > Support Departments.
- Set up email piping so you can manage tickets using the WHMCS Support Desk. For full instructions on this, see Email Piping.
- Ensure the WHMCS Cron Job is set up and configure automated tasks in Configuration () > System Settings > Automation Settings.
- Place some test orders on your website to check everything works as expected.
Watch the video tutorial for this feature.
For further guidance, you can watch video tutorials we have prepared for the above tasks at youtube.com/whmcs.
Detailed Configuration Instructions: Setup/Configuration
What's Next
Click Configuration () or, prior to WHMCS 8.0, Setup to view the Setup Tasks Checklist, this itemizes the recommended configuration steps to make the most of WHMCS.
You may already have some clients and wish to start managing them through WHMCS, they'll need to be imported. For instructions doing so, refer to the Importing Data page.
Make sure you are up-to-date with all the latest fixes, updates and features introduced in your version of WHMCS by reading the Release Notes.
We use a licensing system to ensure that only those who have paid for the software may use it. Learn more about this works and what you need to do if you wish to move your WHMCS installation on the Licensing page.
Learn to use WHMCS: Using WHMCS and Howtos
Where do I get help?
Documentation
Our documentation is comprehensive and covers every aspect of the WHMCS software. If you're unsure about any of the options on a given page simply click the yellow "Help" link in the top-right corner to be taken directly to the relevant section. You can also search the documentation using the Search box in the top-right corner of this page. Some useful sections are:
Help Guides
A range of self-help guides are available at help.whmcs.com assist with many common tasks in the WHMCS software, including Setup and Configuration, guiding you through the System Settings and Payments & Currency.
There is also an extensive troubleshooting section should you encounter any problems.
Video Tutorials
These Youtube video tutorials provide a visual step by step walk-through of all the common setup and configuration tasks you’ll need to perform when getting started with WHMCS. We recommend watching these before configuring the software.
Community
Our Community is home to a very active community of experienced WHMCS users that are always willing to help and discuss new ideas. These forums are primarily a place for discussion between customers and so you should not expect to receive a response from staff here.
Support Ticket
You should submit a support ticket when you are unable to find answers to your questions using any of the above resources. If you have a monthly license you are entitled to support at any time but if on an owned license, you may be required to renew your support and upgrades before help can be provided.
Getting Help: https://www.whmcs.com/support/