Move WHMCS to a New Subdomain

In some circumstances, you may need to move your existing WHMCS installation to a different subdomain on the same server. For example, you may want to start using members.example.com instead of clients.example.com. This may require additional steps if the move changes your domain, IP address, or directory structure.

Need help with moving your WHMCS installation? Have our team move your WHMCS installation for you.
For steps to move your WHMCS installation from one server to another, see Move WHMCS to a New Server.

Moving WHMCS to a New Subdomain

To move WHMCS to a different subdomain on the same server:

1. Move your files.

Move the your WHMCS installation’s files to the new location on the server.

If you do not want to move them manually, you could instead set the new subdomain’s path to point to the subdirectory that already contains the WHMCS files.

2. 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.
For information on checking your license key information and forcing license updates, see License Information.

3. Change your system URL.

Update the WHMCS System URL setting at Configuration () > System Settings > General Settings to point to the new subdomain.

For more information, see Update the System URL.

4. Update your database.

In your WHMCS installation’s database, update the following values in the tblconfiguration table to use the new subdomain:

  • Domain
  • LogoURL
  • SystemURL

5. Update the configuration.php file.

In the configuration.php file, update any values that reference the previous subdomain to use the new subdomain.

For more information, see The configuration.php File.

6. Update the system cron path.

If you customized the system cron job’s path, update the /crons/config.php file to use the new subdomain.

For more information, see Update the Cron Configuration File.

7. Update your customizations.

If any of your customizations include hardcoded links to your WHMCS installation, update them to use the new subdomain.

We strongly recommend using relative links instead of hardcoded links.

After you finish moving your WHMCS installation to a new subdomain, we also recommend updating:

  • Your customized email templates at Configuration () > System Settings > Email Templates.
  • Your email signature and global email header and footer in the Mail tab at Configuration () > System Settings > General Settings.
  • Your predefined support ticket replies at **Support > Predefined Replies.

Continuing to use the old subdomain in these locations will not prevent WHMCS from functioning normally on the new subdomain. However, the link will not function unless you set up forwarding from your previous subdomain to the new subdomain.

licensing configuration-php

Last modified: November 12, 2024