Introduction
WHMCS is the gold standard billing and automation platform for web hosting companies. Whether you are launching your first hosting business or migrating from another platform, getting WHMCS installed correctly from the start sets the foundation for everything that follows.
This guide walks you through the complete WHMCS installation process, from server preparation to your first login.
Before You Begin: Prerequisites
Before installing WHMCS, ensure your server meets the following requirements:
- PHP: Version 7.4 or later (PHP 8.x recommended)
- MySQL or MariaDB: Version 5.7+ or MariaDB 10.x+
- Web Server: Apache (with mod_rewrite enabled) or Nginx
- Required PHP Extensions: curl, gd, imap, json, mbstring, openssl, pdo, xml, zip
- SSL Certificate: Required for all WHMCS installations (Let's Encrypt is free and widely supported)
- WHMCS Licence: Purchase a licence from the WHMCS website before installation
Step 1: Download WHMCS
Log into your WHMCS account at whmcs.com and download the latest version of WHMCS from your client area. The download is a zip file containing all the WHMCS application files.
Step 2: Create a MySQL Database
Before uploading WHMCS, create a dedicated database for it:
- Log into your cPanel or server control panel
- Navigate to MySQL Databases
- Create a new database (e.g.,
yourusername_whmcs) - Create a new database user with a strong password
- Grant all privileges on the new database to that user
- Note down the database name, username, and password — you will need these during installation
Step 3: Upload WHMCS Files
- Extract the WHMCS zip file on your local computer
- Connect to your server via FTP or SFTP (using FileZilla or a similar client)
- Upload all extracted files to your desired directory (e.g.,
public_htmlfor your root domain, orpublic_html/billingfor a subdirectory) - This upload may take several minutes depending on your connection speed
Step 4: Configure File Permissions
Certain WHMCS directories require specific permissions to function correctly. Set the following via your FTP client or server file manager:
configuration.php— 644attachments/— 777downloads/— 777templates_c/— 777
Step 5: Run the WHMCS Installer
- Visit your WHMCS URL in a browser (e.g.,
https://yourdomain.com/install/) - The installer will check your server for compatibility — resolve any warnings before proceeding
- Accept the WHMCS licence agreement
- Enter your database credentials (database name, username, password, host)
- Enter your WHMCS licence key
- Create your admin username and password
- Complete the installation
Step 6: Delete the Installation Directory
After installation, immediately delete the /install/ directory from your server. Leaving it in place is a serious security vulnerability.
Step 7: Configure Core WHMCS Settings
Log into your WHMCS admin area and configure the essentials:
- Company name, logo, and contact details
- Email settings (SMTP configuration for outgoing mail)
- Currency and tax settings
- Payment gateway integration
- Cron job setup for automated billing and renewals
Step 8: Install a Theme and Order Form
The default WHMCS theme is functional but generic. Installing a premium theme and order form immediately gives your new WHMCS installation a professional appearance. Explore the HM products for theme and order form options designed to work together seamlessly.
Need Help with Installation?
WHMCS installation involves multiple technical steps that can go wrong if any configuration is off. HostModules offers a professional WHMCS Installation Service starting from $29 — we handle the entire setup so you can focus on your business.
Conclusion
WHMCS installation is a methodical process. Follow each step carefully, double-check your database credentials and file permissions, and delete the install directory immediately after completion. Once installed, the real work begins — configuring your products, gateway, and brand for a polished, professional hosting platform.