Difference between revisions of "Getting Started"

From WHMCS Documentation

m
(Configuring WHMCS)
 
(35 intermediate revisions by 3 users not shown)
Line 1: Line 1:
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.
+
This guide covers the basics of WHMCS starting with ordering a licence, downloading the software, installing it, and getting started using it.  
  
==Buying a licence==
+
==Buying a Licence==
[[File:Order licence.png|thumb|Order Now Page]]
 
The very first thing to do is buy a licence for the WHMCS software. Simply click the [http://www.whmcs.com/order-now/ 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 branded/unbranded and from leased to owned 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 [http://www.whmcs.com/addons/ Addons Page].
+
First, buy a licence for the WHMCS software. To do this, click [http://www.whmcs.com/order-now/ Order Now]. We offer a range of licence options to suit all budgets. You can switch between tiers at any time.
  
 +
We offer many great addons to increase the value of WHMCS, from a fully-integrated live chat solution to a mobile phone app to a full project management system. To see all of these options, see our [http://www.whmcs.com/addons/ Addons] list.
  
 +
Buy a license https://www.whmcs.com/pricing
  
Buy a licence http://www.whmcs.com/order-now/
+
==Downloading the Software==
  
 +
<html><a href="https://www.youtube.com/watch?v=nxd8VYu8u5s&list=PLfpgUwyOgC7C4wwPhB7jEqSp_esXB31Jb&index=2&t=0s" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
  
==Downloading the software==
+
After you purchase a license, download WHMCS from the [https://www.whmcs.com/members/ WHMCS Members Area]:
 
+
#Select '''My Licenses''' in the '''Services''' menu.
[[File:Videotutorial.png‎|center|link=https://www.youtube.com/watch?v=MihmQhrmhnI&hd=1|Watch Video Tutorial]]
 
 
 
 
 
Once a licence has been purchased, the software can be downloaded from our [https://www.whmcs.com/members/clientarea.php Members Area]:[[File:Download.png|thumb|File Download Page]]
 
#Click the My Licenses & Services link under the Services menu
 
 
#Select one of your active license keys to view the details
 
#Select one of your active license keys to view the details
#Choose the latest stable version to download from the downloads tab on this page<br/>If you chose to purchase any addons, their downloads will also appear here (with the exception of the mobile apps and the configurable packages addon).
+
#Click '''Download Now''' to download the latest stable release. If you chose to purchase any addons that require extra files, their downloads will also appear here.
#Save the zip file to your computer.
+
#Save the ZIP file to your computer.
 
 
 
 
 
 
Download the software: https://www.whmcs.com/members/clientarea.php
 
  
 +
Download the software: https://www.whmcs.com/members/
  
 
==Installing the software==
 
==Installing the software==
  
[[File:Videotutorial.png‎|center|link=https://www.youtube.com/watch?v=MihmQhrmhnI&hd=1|Watch Video Tutorial]]
+
<html><a href="https://www.youtube.com/watch?v=nxd8VYu8u5s&list=PLfpgUwyOgC7C4wwPhB7jEqSp_esXB31Jb&index=2&t=0s" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
 
 
 
 
Next the WHMCS software must be installed on your server. Please check with your server admin/hosting provider that your server meets the [http://docs.whmcs.com/System_Requirements 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 [[Installing_WHMCS|detailed installation instructions]] are available.
+
Next, install WHMCS on your server, making sure that your server meets the [[System Requirements]].  
[[File:Installing.png|thumb|Installing WHMCS]]
 
#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: http://docs.whmcs.com/Installing_WHMCS
+
* You can use several different methods to do this.
 +
* Depending on your server access level, you may need to consult your system administrator or hosting provider for assistance.
  
 +
Detailed installation instructions: [[Installing WHMCS]] and [[Install On The Command Line]]
 +
<html><a href="https://www.whmcs.com/services#installation?utm_medium=docs" class="docs-video-tutorial"><em><small><b>Need help with installation?</b> Check our available services.</small></em><span class="button">Services</span></a></html>
  
 
==Further Security Steps==
 
==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: http://docs.whmcs.com/Further_Security_Steps
+
Your WHMCS installation will contain sensitive data. We recommend taking extra precautions to ensure your server and its software are secure.
  
 +
  Steps to secure your server: [[Installing WHMCS]] and [https://help.whmcs.com/m/installation/l/1075203-securing-your-whmcs-installation Securing Your Installation]
  
 
==First Login==
 
==First Login==
[[File:Admin summary.png|thumb|Admin Summary Page]]
+
<html><a href="https://www.youtube.com/watch?v=M_Ak62s_L1k&list=PLfpgUwyOgC7C4wwPhB7jEqSp_esXB31Jb&index=3&t=0s" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
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 http://www.yourdomain.com/whmcs/admin using the username and password created during the installation process.
+
 
 +
[[File:82Dashboard.png|thumb|Admin Summary Page]]
  
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.
+
After installation, you can begin configuring WHMCS through the WHMCS Admin Area. To log in and get started, visit the URL at which you installed the software (for example, <tt>https://www.example.com/whmcs/admin</tt>) using the username and password you created during the installation process.
  
Administration Area Documentation: http://docs.whmcs.com/Admin_Area
+
When you log in, you will immediately see the Admin Area Dashboard, from which you can access all of the needed tools and settings.
  
 +
Administration Area Documentation: [[Admin Area]]
  
 
==Configuring WHMCS==
 
==Configuring WHMCS==
  
After installation is completed, we recommend that you go through and configure your new WHMCS system in the following order:
+
<html><a href="https://www.whmcs.com/services#installation?utm_medium=docs" class="docs-video-tutorial"><em><small><b>Configuration Service:</b> Have our team configure WHMCS for you.</small></em><span class="button">Services</span></a></html>
 +
 
 +
After you complete installation, we recommend that you configure WHMCS in the following order:
  
#Login to the Admin Area and configure your General Settings (Setup > [[Configuration|General Settings]])
+
# Perform the recommended [[Further Security Steps]].
#Setup your Payment Gateways (Setup  > [[Payment Gateways]])
+
# Configure your general settings ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''').
#Add your servers to WHMCS (Setup  > Products/Services  > [[Servers]])
+
# Set up your payment gateways ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[Apps and Integrations|Apps & Integrations]]''').
#Setup your Products & Services (Setup  > Products/Services  > [[Products and Services]])
+
# Set up your products and services ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''').
#Enter your domain registrar account details (Setup  > Products/Services  > [[Domain Registrars]])
+
# Configure your domain pricing ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Domain Pricing]]''').
#Configure your Domain Pricing (Setup  > [[Domains_Configuration|Domain Pricing]])
+
# Set up your support ticket departments ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Support Departments]]''').
#Setup your Support Ticket Departments (Setup  > [[Support_Center|Support Departments]])
+
#Set up [[Email Piping|email piping]] to manage tickets using the WHMCS Support Desk.
#Setup email piping so you can manage tickets using the WHMCS Support Desk - for full instructions on this please see the [[Email Piping]] article
+
# Create and configure the WHMCS cron job and its automated tasks ('''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Automation Settings]]''').
#Ensure the WHMCS Cron Job is setup and configure automated tasks (Setup  > [[Automation Settings]])
+
# Place some test orders on your website to check your setup.
#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]]
+
For help, watch [https://youtube.com/whmcs 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/]
 
  
  Detailed Configuration Instructions: http://docs.whmcs.com/Setup/Configuration
+
  Detailed Configuration Instructions: [[Setup/Configuration]]
  
 
==What's Next==
 
==What's Next==
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.
+
 
+
The '''Setup Tasks''' checklist itemizes the recommended configuration steps to make the most of WHMCS. In WHMCS 8.5 and later, you can see this list at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings''' when you click '''Click here to view the setup tasks'''.
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]].
+
 
 
+
* In WHMCS 8.0 through 8.4, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings'''.
 +
* Prior to WHMCS 8.0, go to '''Setup'''.
 +
 +
You may already have some clients and wish to start managing them through WHMCS. If so, they'll need to be imported. For instructions, see [[Importing Data]].
 +
 +
Make sure you are up-to-date with all the latest fixes, updates, and features 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.
 
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: http://docs.whmcs.com/Using_WHMCS_and_Howtos
+
  Learn to use WHMCS: [[Using WHMCS and Howtos]]
 
 
  
 
==Where do I get help?==
 
==Where do I get help?==
 
===Documentation===
 
===Documentation===
 
[[File:Docs.gif|right]]
 
[[File:Docs.gif|right]]
Our '''[http://docs.whmcs.com 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:
+
Our '''[https://docs.whmcs.com 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 '''[[Admin Area|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:
  
 
*[[Setup/Configuration]]
 
*[[Setup/Configuration]]
Line 101: Line 94:
 
*[[Customising WHMCS]]
 
*[[Customising WHMCS]]
 
*[[Troubleshooting]]
 
*[[Troubleshooting]]
 +
 +
===Help Guides===
 +
[[File:Guides.png|right]]
 +
A range of self-help guides are available at [https://help.whmcs.com/ help.whmcs.com] assist with many common tasks in the WHMCS software, including [https://help.whmcs.com/m/setup Setup and Configuration], guiding you through the [https://help.whmcs.com/m/system System Settings] and [https://help.whmcs.com/m/payments Payments & Currency].
 +
 +
There is also an extensive [https://help.whmcs.com/m/troubleshooting troubleshooting section] should you encounter any problems.
  
 
===Video Tutorials===
 
===Video Tutorials===
 
[[File:Tutorials.gif|right]]
 
[[File:Tutorials.gif|right]]
These flash '''[http://www.whmcs.com/get-support/video-tutorials/ 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.
+
These Youtube '''[https://www.youtube.com/whmcs/ 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 Forums===
+
===Community===
 
[[File:Community.gif|right]]
 
[[File:Community.gif|right]]
'''[http://forums.whmcs.com/ Our forums]''' are home to a very active community of experienced WHMCS users that are always willing to help and discuss new ideas. The forums are primarily a place for discussion between customers and so you should not expect to receive a response from staff here.
+
'''[https://whmcs.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===
 
===Support Ticket===
 
[[File:Submitticket.gif‎|right]]
 
[[File:Submitticket.gif‎|right]]
You should submit a '''[http://www.whmcs.com/get-support/ 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.
+
You should submit a '''[https://www.whmcs.com/support/ 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: http://www.whmcs.com/get-support/
+
  Getting Help: https://www.whmcs.com/support/

Latest revision as of 13:45, 19 April 2023

This guide covers the basics of WHMCS starting with ordering a licence, downloading the software, installing it, and getting started using it.

Buying a Licence

First, buy a licence for the WHMCS software. To do this, click Order Now. We offer a range of licence options to suit all budgets. You can switch between tiers at any time.

We offer many great addons to increase the value of WHMCS, from a fully-integrated live chat solution to a mobile phone app to a full project management system. To see all of these options, see our Addons list.

Buy a license https://www.whmcs.com/pricing

Downloading the Software

Watch the video tutorial for this feature  

After you purchase a license, download WHMCS from the WHMCS Members Area:

  1. Select My Licenses in the Services menu.
  2. Select one of your active license keys to view the details
  3. Click Download Now to download the latest stable release. If you chose to purchase any addons that require extra files, their downloads will also appear here.
  4. 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, install WHMCS on your server, making sure that your server meets the System Requirements.

  • You can use several different methods to do this.
  • Depending on your server access level, you may need to consult your system administrator or hosting provider for assistance.
Detailed installation instructions: Installing WHMCS and Install On The Command Line

Need help with installation? Check our available services.Services

Further Security Steps

Your WHMCS installation will contain sensitive data. We recommend taking extra precautions to ensure your server and its software are secure.

 Steps to secure your server: Installing WHMCS and Securing Your Installation

First Login

Watch the video tutorial for this feature  

Admin Summary Page

After installation, you can begin configuring WHMCS through the WHMCS Admin Area. To log in and get started, visit the URL at which you installed the software (for example, https://www.example.com/whmcs/admin) using the username and password you created during the installation process.

When you log in, you will immediately see the Admin Area Dashboard, from which you can access all of the needed tools and settings.

Administration Area Documentation: Admin Area

Configuring WHMCS

Configuration Service: Have our team configure WHMCS for you.Services

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

  1. Perform the recommended Further Security Steps.
  2. Configure your general settings (Configuration () > System Settings > General Settings).
  3. Set up your payment gateways (Configuration () > Apps & Integrations).
  4. Set up your products and services (Configuration () > System Settings > Products/Services).
  5. Configure your domain pricing (Configuration () > System Settings > Domain Pricing).
  6. Set up your support ticket departments (Configuration () > System Settings > Support Departments).
  7. Set up email piping to manage tickets using the WHMCS Support Desk.
  8. Create and configure the WHMCS cron job and its automated tasks (Configuration () > System Settings > Automation Settings).
  9. Place some test orders on your website to check your setup.

For help, watch video tutorials.

Detailed Configuration Instructions: Setup/Configuration

What's Next

The Setup Tasks checklist itemizes the recommended configuration steps to make the most of WHMCS. In WHMCS 8.5 and later, you can see this list at Configuration () > System Settings when you click Click here to view the setup tasks.

  • In WHMCS 8.0 through 8.4, go to Configuration () > System Settings.
  • Prior to WHMCS 8.0, go to Setup.

You may already have some clients and wish to start managing them through WHMCS. If so, they'll need to be imported. For instructions, see Importing Data.

Make sure you are up-to-date with all the latest fixes, updates, and features 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

Docs.gif

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

Guides.png

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

Tutorials.gif

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

Community.gif

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

Submitticket.gif

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/