Upgrading nopCommerce

Auto-Install Applications > nopCommerce

This chapter describes how to upgrade nopCommerce to the latest version. You might want to do this because you've seen a message at the nopCommerce news section of your dashboard telling you that a new release is available. nopCommerce doesn't support automatic upgrades, you have to do it manually.

Follow the next steps:

  1. Make a backup of everything on your site, including the database. This is extremely important so that you can roll back to a running site no matter what happens during migration.
  2. Then you have to execute SQL upgrade scripts. You have to execute them stepwise. For example, if your current version is 3.90 and the latest available version is 4.20, then you have to upgrade to 4.00, then to 4.10, and then to 4.20. So download the required upgrade scripts from our the download nopCommerce page. Once an upgrade script is downloaded, execute it over your database.
  3. Remove all files from the previous version (all except App_Data\Settings.txt and App_Data\InstalledPlugins.txt).
  4. Upload the new site files (get the latest version here).
  5. Rename file setting.txt to dataSettings.json and InstalledPlugins.txt to plugins.json (for 4.00 and 4.10, rename InstalledPlugins.txt to installedPlugins.json) and update content with json structure.
  6. Ensure that everything is OK.

As you deploy, make sure that the target Settings.txt (or dataSettings.json) and InstalledPlugins.txt (or plugins.json) files are updated as per latest nopCommerce version, so that the production site continues to point to the production database.


If you stored your pictures on the file system, then also backup them (\wwwroot\Images\) and copy back after the upgrade.


(upgrading from 3.X to 4.X): If you want to upgrade from a version 3.90 to the latest version, you would need to install 4.00 first (over the existing database), run the 3.90 to 4.00 migration SQL script, and then upgrade to 4.10, 4.20 etc.


If you experience problems after the upgrade, you can always restore your backup and replace the files with ones from your previous version. You can always post a question on our forums.


If when doing advanced search on our forums you cannot find what you need, then try a Google search focused into nopCommerce site: [your search words site:nopcommerce.com].