System Upgrade

The Web Setup Wizard is deprecated as of Magento 2.3.6 and removed in Magento 2.4.0. As an alternative, use the command line to install or upgrade Magento, as well as extensions.

The System Upgrade tool can be used to upgrade your Magento installation from the Admin. The upgrade is a three-step process that should take place during off-peak hours. Before upgrade takes place, your store is put into maintenance mode, checked for readiness, and backed up.

We strongly recommend reviewing the latest release notes and system requirements in the developer documentation.

Upgrade requirements

  • Only the primary account holder is authorized to download code from the repository.
  • The authorization keys that are used to download code must be generated from the primary account.
  • The merchant or developer must submit a ticket to Support and request authorization for the download.

Caching and reindexing

Always flush the cache when upgrading from one version of Open Source or Commerce to another. Two upgrade examples include: upgrading from Magento Open Source 2.2.X to 2.3.X and upgrading from Magento Open Source 2.3.X to Magento Commerce 2.3.X.

Important: Always flush the cache after installing or upgrading Magento, or any extensions and modules.

For developer information on upgrades, see Command Line Upgrade in the developer documentation. The upgrade instructions include scripts to help run and complete your upgrades. These steps require developer assistance.

Web setup - System Upgrade System Upgrade

Upgrade your Magento installation

  1. Retrieve your access keys:

    • Go to Magento Marketplace and log into your account.

    • On the Marketplace tab, go to My Products and click Access Keys.

      If you need to generate a new set of access keys, click Create a New Access Key.

    • Find the set of access keys (public key and private key) in the list and make them available for the next steps.

  2. Log in to the Admin of your Magento store as a user with full administrator rights.

  3. On the Admin sidebar, go to System > Tools > Web Setup Wizard.

    Web Setup Wizard - Tools Web Setup Wizard

  4. Click Extension Manager.

    Web setup - system upgrade System Upgrade

  5. When prompted, follow the instructions to copy and paste the Public Access Key and Private Access Key from your Marketplace account. Then, click Submit.

  6. Follow the onscreen instructions to complete the following steps:

    • Step 1: Select Version
    • Step 2: Create Backup
    • Step 3: System Upgrade
  7. Flush the cache and reindex when complete.