Install & Configure WHMCS on Your Server

by | May 10, 2025 | WHMCS Guides

Learn how to install and configure WHMCS on your server in this step-by-step guide. Perfect for beginners starting a web hosting or automation business.

Introduction

If you’re starting a web hosting business or need to automate billing and client management, WHMCS is one of the most reliable platforms. However, installing and configuring it can seem overwhelming if you’re new to it.

This guide will walk you through the complete WHMCS installation and configuration process, step by step.

What is WHMCS?

WHMCS (Web Host Manager Complete Solution) is a powerful platform designed for web hosts and digital service providers. It handles everything from automated billing and domain management to customer support and provisioning.

With WHMCS, you can:

  • Manage clients
  • Automate invoices and payments
  • Offer web hosting and domain services
  • Integrate with control panels like cPanel and Plesk
  • Provide ticket-based support

What is WHMCS?

WHMCS (Web Host Manager Complete Solution) is a powerful platform designed for web hosts and digital service providers. It handles everything from automated billing and domain management to customer support and provisioning.

With WHMCS, you can:

  • Manage clients
  • Automate invoices and payments
  • Offer web hosting and domain services
  • Integrate with control panels like cPanel and Plesk
  • Provide ticket-based support

Step 2: Download WHMCS

  1. Go to https://www.whmcs.com
  2. Log into your WHMCS Client Area
  3. Navigate to Services > My Licenses
  4. Download the latest stable version of WHMCS

Step 3: Upload WHMCS to Your Server

  • Extract the downloaded ZIP file on your local machine
  • Upload the contents of the /whmcs folder to your server using FTP or File Manager
  • Rename the file configuration.php.new to configuration.php

Step 4: Run the Installer

  1. Visit https://yourdomain.com/whmcs/install/install.php in your browser
  2. Follow the installation wizard:
    • Enter your WHMCS license key
    • Provide database connection details
    • Create your admin account

After installation is complete, delete the /install folder from your server for security.

Step 5: Configure General Settings

Log into the WHMCS admin area and navigate to:
System Settings > General Settings

Set the following:

  • Company Name
  • Default Language and Currency
  • System URL (must be HTTPS)
  • Logo and branding
  • Email addresses

Step 6: Set Up Payment Gateways

To receive client payments, configure at least one payment gateway:

  1. Go to System Settings > Payment Gateways
  2. Activate gateways such as:
    • PayPal
    • Stripe
    • Razorpay (via module)
  3. Enter the required API or account credentials

Run test transactions to ensure integration works correctly.

Step 7: Create Hosting Products

  1. Navigate to Products/Services > Create a New Group
  2. Click Create a New Product
  3. Choose your product type (e.g., Shared Hosting)
  4. Define pricing, features, and provisioning settings
  5. Select the module (e.g., cPanel) for automatic account creation

WHMCS relies on a cron job to handle automated tasks like:

  • Invoice generation
  • Payment reminders
  • Suspension of unpaid accounts

You’ll find the correct cron command under:
Help > Cron Commands

Add this to your server’s Cron Jobs (in cPanel or via SSH), usually scheduled every 5 minutes.

Step 9: Customize the Client Area (Optional)

You can personalize the look and feel of your WHMCS client area:

  • Upload your company logo
  • Install a modern theme like Lagom
  • Add custom pages and menus
  • Use modules for SEO, language translation, and promotions

Step 10: Test Your Setup

Before going live:

  • Create a test client
  • Order a test product
  • Complete a test payment
  • Review all emails and admin notifications

Fix any issues before officially launching your services.

Conclusion

Setting up WHMCS correctly from the start is crucial for automating your hosting business. With this guide, you should now have a working, secure, and functional WHMCS installation ready for clients.

If you need help with WHMCS installation, configuration, or custom modules, feel free to contact us. We specialize in WHMCS development and support services tailored to your business needs.