WHMCS for Beginners: A Complete Setup Guide (2025)

by | May 9, 2025 | WHMCS Guides

If you’re starting a web hosting business or want to automate client billing and support, WHMCS is the go-to platform. But if you’re a beginner, installing and setting it up can be confusing.

In this step-by-step guide, we’ll show you how to install WHMCS, configure basic settings, and get ready to start selling hosting or services.

What is WHMCS?

WHMCS stands for Web Host Manager Complete Solution. It’s an all-in-one client management, billing, and support platform for hosting providers and developers.

With WHMCS, you can:

  • Automate invoices and payments
  • Offer hosting plans and domains
  • Integrate with cPanel, Plesk, and more
  • Handle support tickets and emails

Step 1: Check Hosting Requirements

Before installation, make sure your server supports:

  • PHP 8.1 or 8.2
  • MySQL 5.7+ or MariaDB 10.3+
  • IonCube Loader enabled
  • SSL certificate (HTTPS)

A VPS or shared hosting with WHM/cPanel is ideal.

Step 2: Download WHMCS

  1. Visit https://www.whmcs.com
  2. Login or create an account
  3. Go to Client Area > Services > My Licenses
  4. Download the latest WHMCS version

Step 3: Upload Files to Your Server

  • Unzip the downloaded package.
  • Upload all files inside the /whmcs folder to your hosting account using FTP or File Manager.
  • Rename the configuration.php.new file to configuration.php.

Step 4: Start the Installation

  1. Visit https://yourdomain.com/whmcs/install/install.php
  2. Follow the installation wizard:
    • License Key
    • Database setup
    • Admin account creation

❗ After installation, delete the /install folder for security.

Step 5: Configure Basic Settings

Once logged into the admin area:

  • Go to System Settings > General Settings
  • Set your:
    • Company name
    • Domain
    • Email address
    • Logo
    • Default currency and language

Step 6: Setup a Payment Gateway

To accept payments:

  1. Go to System Settings > Payment Gateways
  2. Choose options like:
    • PayPal
    • Stripe
    • Razorpay (with module)
  3. Enter your credentials and activate

Step 7: Create Hosting Products

  1. Navigate to Products/Services > Create a New Group
  2. Then click Create a New Product
  3. Set up:
    • Product name (e.g., Basic Hosting)
    • Pricing
    • Module settings (e.g., cPanel auto provisioning)

Step 8: Automate Tasks

Set up the cron job:

  • Go to Help > Cron Commands
  • Add the recommended cron job to your server (usually via cPanel)

This allows WHMCS to send invoices, reminders, and suspend unpaid accounts.

Step 9: Customize the Client Area (Optional)

Use themes like Lagom or custom ones to improve the design. You can also:

  • Add your logo
  • Add custom pages (e.g., About Us, Contact)
  • Use modules for promotions, SEO, or menus

Step 10: Go Live!

Test your setup:

  • Register as a client
  • Order a product
  • Make a payment

Fix any issues before launching publicly.

Conclusion

WHMCS is a powerful platform, but the setup can feel overwhelming at first. With this guide, you should have a working billing system ready to grow your business.

Need help with WHMCS installation, setup, or customization? WHMCSModules.org — we offer expert WHMCS services tailored to your needs.