Upgrade WHMCS to Latest Version on cPanel Server
Upgrading WHMCS ensures better security, performance, and access to new features. In this guide, you will learn how to safely upgrade WHMCS using only cPanel tools (File Manager & Backup Manager) — no SSH required.
🔧 Requirements
- Access to cPanel
- Valid WHMCS license
- Basic understanding of File Manager
⚠️ Important: Take Full Backup
Before starting the upgrade, always take a full backup of your files and database to prevent data loss.
📁 Step 1: Backup WHMCS Files (File Manager)
1. Login to your cPanel account
2. Open File Manager
3. Go to your WHMCS installation folder (usually public_html)
4. Select all files → Click Compress
5. Save as: whmcs_backup.zip
This will create a full backup of your WHMCS files.
🗄️ Step 2: Backup Database (Backup Manager)
1. Go back to cPanel dashboard
2. Open Backup or Backup Wizard
3. Click Download a MySQL Database Backup
4. Select your WHMCS database and download it
You can find your database name in:
/public_html/configuration.php
⬇️ Step 3: Download Latest WHMCS
Download the latest WHMCS version from the official website:
Login is required using your WHMCS client account.
📤 Step 4: Upload WHMCS Files (File Manager)
1. Open File Manager in cPanel
2. Navigate to your WHMCS directory (e.g., public_html)
3. Click Upload
4. Upload the WHMCS zip file
📦 Step 5: Extract & Replace Files
1. After upload, select the ZIP file
2. Click Extract
3. Open extracted folder (usually named whmcs)
4. Select all files inside → Click Move
5. Move them to your main WHMCS directory (e.g., public_html)
6. Confirm overwrite when prompted
Important: This will replace old files but keep your configuration safe.
🔐 Step 6: Update Admin Directory
If you renamed your admin folder (for example: billing):
1. Rename old admin folder to backup:
billing → billing_backup
2. Rename new admin folder:
admin → billing
3. If you had password protection (.htaccess), reapply it
⚙️ Step 7: Check File Permissions
Ensure important folders have correct permissions:
- Folders: 755
- Files: 644
You can update permissions by right-click → Change Permissions in File Manager.
🚀 Step 8: Run Upgrade Script
Open the following URL in your browser:
https://yourdomain.com/install/install.php
- Accept license agreement
- Follow upgrade instructions
🧹 Step 9: Delete Install Folder
After upgrade is complete:
1. Go to File Manager
2. Navigate to WHMCS directory
3. Delete the install folder
This step is mandatory for security reasons.
🔑 Step 10: Access Admin Panel
https://yourdomain.com/billing/
✅ Upgrade Completed Successfully
Your WHMCS installation is now updated and ready to use.
💡 Best Practices
- Upgrade during low traffic hours
- Disable cron jobs temporarily
- Always keep backups before updates
- Test on staging environment if possible
- Check WHMCS release notes before upgrading