Magento 2 Upgrade

The guide to upgrade Magento 2 stores using Composer, Wizard or Manually and how to handle Errors during the process.

Ways to Upgrade Magento 2 Installation #

Different approaches can be take to update a Magento 2 installation. Below are 3 methods you can use to get your Magento 2 store to the latest version available.

Upgrade Wizard #

Upgrade Magento 2 using the Web Setup Wizard provided by Magento in backend. This is the simplest option and less technical as you only needed to login into your Magento 2 Admin area and use a GUI.

  1. The option to Upgrade via Wizard is in the backend under a menu option System > Tools called Web Setup Wizard.

If you don’t see such a option don’t worry, there is a bug that hides the option, you can directly access it via:

Replace with your backend url in the browser url input and hit enter.

Web Setup Wizard

You can use it to install extensions from the Magento Marketplace but also to Upgrade Magento 2.

  1. Select System Upgrade

  2. (Optional) If you have never used the Magento Marketplace before you will be required to add the Marketplace credentials in the System config page. Credentials can be obtained from Marketplace »

System config for Marketplace

Enter Public Access Key, Private Access Key and Click Save Config.

Click on System Upgrade in the left tab.

In the Step 1: Select Version area Magento wizard will now look for available versions and the Magento Core Components select will offer a version to upgrade to.

After selecting a version form Magento Core Components click on Next in the top part of the screen.

Upgrade Composer #

Upgrade Magento 2 using Composer

  1. SSH into the server and go to wwwroot folder.

  2. Execute below commands in wwwroot folder

$ composer require magento/product-community-edition 2.0.5 --no-update
$ composer update
$ rm -rf var/di var/generation
$ bin/magento cache:flush
$ bin/magento setup:upgrade
$ bin/magento setup:di:compile
$ bin/magento indexer:reindex
  • Replace “2.0.5” in the first line composer require magento/product-community-edition 2.0.5 --no-update with the latest version number, you can get this on the Magento 2 Releases » GitHub page.

After executing commands above you can check the Magento 2 version is upgraded via command line:

$ bin/magento --version

This will show you the version:

Magento CLI 2.3.0

where 2.3.0 is the latest version installed

Upgrade Manually #

Upgrade Magento 2 by manual copy/paste from a newer version if the other 2 above fail.

  1. Download latest Magento 2 from Magento Tech Resources »
  2. Unzip the archive in your Magento root folder by overwriting all current folder files.
  3. Run $ bin/magento setup:upgrade via SSH

Upgrade Errors #

Errors can appear during a Magento 2 Upgrade on all 3 methods above.

Readiness Check #

This is a important step in the Upgrade Wizard process. If it fails a message will be displayed Error! You need to resolve these issues to continue.

This step does a check of :

  • Updater Application Availability
  • Cron Scripts
  • PHP Settings
  • PHP Extensions Check

On each of these checks there is a link to the Magento Docs on why they might fail that you can follow.

How to Fix Magento 2 Errors That Appear During a Upgrade #

Published: Mar 10, 2019. Updated: September 12, 2020.

Magento 2 Installation

How to setup and install Magento 2 in you server


Magento 2 Extension

Magento 2 Extension tutorial, learn what is a Magento 2 Extension how to install or disable in your Magento store.

Magento 2 Elasticsearch

Magento 2 Elasticsearch

Magento 2 Elasticsearch tutorial on how to use and configure as the primary search engine.


Magento 2 SEO

In this SEO guide we will help you get higher rankings by providing Magento 2 SEO Tips

Magento 2 Varnish

Magento 2 Varnish

Magento 2 Varnish. What is Varnish and how it can be used and configured in a Magento 2 store.


Magento 2 API

Magento 2 API tutorial for setting up authentication, Authentication types and URLs that can be used.

Hire us

Need help with Magento 2 Upgrade ?


Technologies we work with

Magento is an open-source e-commerce platform written in PHP
PHP is a popular general-purpose scripting language that is especially suited to web development.
MySQL is an open-source relational database management system.
Redis is an in-memory data structure project implementing a distributed, in-memory key-value database with optional durability.
Varnish is an HTTP accelerator designed for content-heavy dynamic web sites as well as APIs.
Google Tag Manager is a free tool that allows you manage and deploy marketing tags on your website / app
Google Analytics is a web analytics service offered by Google that tracks and reports website traffic
Elasticsearch is a search engine based on the Lucene library.