System Upgrade

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.

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.

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 the DevDocs Command Line Upgrade. The upgrade instructions include scripts to help run and complete your upgrades. These steps require developer assistance.

System Upgrade

To upgrade your Magento installation:

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

  2. On the Admin sidebar, click System.

  3. Under Tools, choose Web Setup Wizard.

    Web Setup Wizard

  4. Click Extension Manager.

    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.