Installing WHMCS: The Complete Setup Guide for Resellers

Verified Knowledge
Quick Summary: Installing WHMCS requires a hosting account, a license, and 5 minutes of your time. Use the cPanel File Manager and MySQL Database Wizard to get started, or use one-click installers like Softaculous.
Prerequisites
Before you start, ensure you have:
- A WHMCS License Key.
- A server or hosting account that meets the WHMCS system requirements.
- PHP 8.2+ with IonCube Loader enabled.
Step 1: Upload the Files
Download the latest version of WHMCS from the members area. Upload the .zip file to your server’s public_html (or a subdirectory like /billing) and extract it.
Step 2: Create a Database
- Go to MySQL Database Wizard in cPanel.
- Create a database (e.g.,
whmcs_db). - Create a user (e.g.,
whmcs_user) and generate a strong password. - Grant All Privileges to the user.
Step 3: Run the Installer
Visit yourdomain.com/install/install.php in your browser.
- License Agreement: Read and accept.
- System Requirements: Ensure everything is green.
- License Key: Enter your key.
- Database Details: Enter the DB name, user, and password you created in Step 2.
Step 4: Admin Account Setup
Create your administrator account. Pro Tip: Use a unique username and a extremely secure password.
Step 5: Post-Installation (Critical Security)
Once the installation is complete, you MUST:
- Delete the
/installdirectory from your server. - Move the
configuration.phpfile permissions to 400 or 444. - Set up your Cron Job. WHMCS needs this to automate all tasks.
php -q /home/username/public_html/whmcs/crons/cron.php
FAQ
Q: Can I install WHMCS on shared hosting?
A: Yes, but for better security and reliability, we recommend a Managed VPS.
Q: What is the Cron Job?
A: It’s a scheduled task that tells WHMCS to check for overdue invoices, renew domains, and suspend overdue accounts every hour.
More from WHMCS
View Category
What is WHMCS? Automation for Hosting & SaaS Businesses
Discover how WHMCS streamlines billing, support, and automation for online businesses, and why it's the industry standard for hosting resellers.

How to Use WHMCS for Domain Reselling: A Guide
Become a domain registrar. Learn how to connect WHMCS to providers like Enom or ResellerClub to sell domains automatically.

Customizing WHMCS Email Templates for Your Brand
Stop sending boring system emails. Learn how to use the WHMCS Email Template Editor to create beautiful, branded notifications that your clients love.