Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
64 lines (39 sloc) 3.03 KB
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{:target="_blank"} and system requirements{:target="_blank"} 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.

{% include %}

For developer information on upgrades, see Command Line Upgrade{:target="_blank"} 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]({% link images/images/web-setup-system-upgrade.png %}){: .zoom} System Upgrade

Upgrade your Magento installation

  1. Retrieve your access keys:

    • Go to Magento Marketplace{:target="_blank"} 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]({% link images/images/web-setup-wizard-tiles.png %}){: .zoom} Web Setup Wizard

  4. Click Extension Manager.

    ![Web setup - system upgrade]({% link images/images/web-setup-system-upgrade.png %}){: .zoom} 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]({% link system/ %}) and [reindex]({% link system/ %}) when complete.

You can’t perform that action at this time.