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.

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: October 29, 2024