Upgrade from v2.x to v3.x

This guide inteded for upgrades from v2.x to v3.x, if you need to upgrade from v3.x to higher version of WHMCMS check this guide instead
In WHMCMS v3.0.0 we've changed files structures, many files files were removed or rewitten (85% of module code was rewritten from scratch), so it is advised to completely remove WHMCMS v2.x files first before upgrading to v3.0.0, below we describe each step to a successful upgrade.

1) Download Latest Version

To download the latest version of WHMCMS login in our client area then follow these simple instructions:

  1. From top navbar click the "My Services" link.
  2. Click on one of your active WHMCMS licenses/purchases to view details.
  3. Click on "Downloads" tab.
  4. The latest version should be at the top in this page, inside it you may find multiple files to download, you will need the one recommended for new installations.

2) Remove Old Files:

While this step are optional but it is recommended for security reasons, as there will be unused and outdated files in your system if you ignore to peform it:

  1. Assuming that your WHMCS installed in sub directory "whmcs" located in the public directory of your domain (http://yourdomain/whmcs/).
  2. Using FTP software (eg. FileZilla) go to the following directory /home/{user}/public_html/whmcs/modules/addons/whmcms/
  3. Delete all contents in that directory.

3) Upload New Files:

  1. Unzip/Extract contents of the file you have downloaded previously inside one of your PC folders.
  2. Inside "Upload" folder, you will find 2 different version of WHMCMS, one that supports PHP 7.2, and the other one supports PHP 5.6 to PHP 7.1, pick one of them based on the version of PHP you have in your website.
  3. Using FTP client (eg. FileZilla) upload the entire folder (/Uploads/PHPx.x) contents inside WHMCS main directory.
  4. Go to Admin Area -> Addons -> WHMCMS and it should automatically run any database upgrades required.

4) Further Steps:

  1. Now you need to go to WHMCMS module settings page and check every single option and what does it offer to you.
  2. Once you configure your module, go back to WHMCMS dashboard, it should tell exactly if there is anything you need to do next (Missing Integration, Configurations, etc).
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Install WHMCMS

1) Downloading WHMCMS To download the latest version of WHMCMS login in our client area then...

Upgrade WHMCMS

This guide inteded for upgrades from v3.0.0 to higher version, if you need to upgrade from v2.x.x...

Template Integration

For all the contents created by WHMCMS to be displayed in client area, a simple template...

Menu Integration

Replacing WHMCS built-in navbars is a simple task in WHMCMS, in this tutorial I will show you how...

SEO Friendly URLs

For WHMCMS Search Engine Friendly URLs to function properly, you need to add few lines of code...