Move WHMCS to a New Server
- Moving WHMCS
- 1. Disable the WHMCS cron job.
- 2. Create a database backup.
- 3. Check our system requirements.
- 4. Transfer your files.
- 5. Restore the database on the new server.
- 6. Reissue your license.
- 7. Update the system URL.
- 8. Check your cron jobs, payment gateways, and email forwarders.
- 9. Update other locations.
- 10. Delete the old WHMCS files.
On this page
- Moving WHMCS
- 1. Disable the WHMCS cron job.
- 2. Create a database backup.
- 3. Check our system requirements.
- 4. Transfer your files.
- 5. Restore the database on the new server.
- 6. Reissue your license.
- 7. Update the system URL.
- 8. Check your cron jobs, payment gateways, and email forwarders.
- 9. Update other locations.
- 10. Delete the old WHMCS files.
In some circumstances, you may need to move your WHMCS installation to a new server. This may require additional steps if the move changes your domain, IP address, or directory structure.
Moving WHMCS
To move WHMCS to a new server:
1. Disable the WHMCS cron job.
Disable or remove the WHMCS cron jobs from the old server. This prevents automation from running and making changes.
2. Create a database backup.
Create a backup of your database.
3. Check our system requirements.
Make sure the new server meets the system requirements.
4. Transfer your files.
Transfer the files to the new server.
5. Restore the database on the new server.
Restore the database via phpMyAdmin on the new server and make any changes to the database settings in the configuration.php
file.
configuration.php
file, see The configuration.php File.6. Reissue your license.
Use the appropriate method to reissue your license for the new location:
- If you purchase your license from WHMCS directly, log in to the WHMCS Member Area, go to Services > My Licenses, select your license key, and click Reissue.
- If you purchase your license from your hosting provider, contact them to reissue the license.
7. Update the system URL.
In the WHMCS Admin Area, update the WHMCS System URL at Configuration () > System Settings > General Settings.
8. Check your cron jobs, payment gateways, and email forwarders.
Check whether the system properly modified your cron jobs, payment gateway callbacks, and email forwarders.
9. Update other locations.
Update your custom directory and storage locations and your redirect URIs for any sign-in integrations, mail providers, or payment gateways that redirect users to WHMCS.
10. Delete the old WHMCS files.
Delete the WHMCS files from the old location.
Last modified: November 12, 2024