Guides & TutorialsUpdating WHMCSManual UpdatesUpdating WHMCS Manually on the Command Line

Updating WHMCS Manually on the Command Line

When a new version of WHMCS is available, in-product notices will appear. We recommend using the Automatic Updater utility to apply updates, but you can also apply updates manually using the command line. This is useful if you are provisioning WHMCS for multiple installations.

Advanced Users Only

We only recommend this method if you are already familiar with WHMCS, SSH, and command line tools.

Prepare to Update

To update WHMCS manually, perform the steps below:

  1. Review the latest system requirements and release notes to ensure that your environment meets the requirements of the new version.
  2. Back up your WHMCS files and MySQL® database using our built-in manual database backup or your preferred backup tools.
    • Do not skip this step.
    • Make certain that you include both the WHMCS files and database.
  3. If you buy your license directly from WHMCS, download the latest full release from our release download page. Otherwise, get this from your license provider.
  4. Upload the distribution's .zip file to the server.
  5. Extract the files to a non-public location (for example, /home/update-staging).
  6. If you have customized the admin directory, rename the /whmcs/admin directory in the new files (if it is present) to match it.


To perform the update:

1. Move the staged files to the existing installation folder, replacing any existing folders and files, using the following command, where /home/path/to/whmcs is the path to your WHMCS installation:

cp -R /home/update-staging/whmcs/* /home/path/to/whmcs
Click to copy

 2. Execute the update script using the following command, where path/to/whmcs/install is the path to your WHMCS installation:

php -f path/to/whmcs/install/bin/installer.php -- -u
Click to copy

For more information about the installation script, see Installing on the Command Line.

3. Follow the onscreen instructions to begin the update process. When the process finishes, a Program Completed success message will appear.

If a failure message appears, see Updating and our update troubleshooting guides.

4. Delete the install directory from your server.

rm -r /home/path/to/whmcs/install
Click to copy

5. If you have customized the location of the crons directory, make certain that you move that directory's contents in your distribution to the custom location.

6. If you have customized the permissions on any files (for example, /crons/pipe.php), reapply those changes.

Check your WHMCS Version

To ensure that WHMCS updated correctly, check whether the expected version number displays in the Admin Dashboard or at Configuration > System Health.