Close [x]

Run System Upgrade

Edit this page on GitHub

Overview of System Upgrade

This section discusses how to start System Upgrade, which upgrades the version of Magento core components as well as any other installed components.

System upgrade refers to updating the Magento 2.x core components and other installed components. To migrate from Magento 1.x to Magento 2, see the Migration Guide.

If you installed the Magento application by cloning the GitHub repository, you cannot use the System Upgrade utility to upgrade the software. Instead, you must update it manually.

Prerequisites

Before continuing, complete all tasks discussed in Prerequisites.

Start System Upgrade from the Magento Admin

To run System Upgrade:

  1. Log in to the Magento Admin as an administrator.
  2. Click System > Web Setup Wizard. The following page displays.

    Specify whether to manage components or upgrade Magento

  3. Click System Upgrade.

    Magento begins searching for core module updates immediately. To also search for component updates, click Yes. A sample follows:

    Magento begins searching for upgrades right away

    The page displays similar to the following when we find components to upgrade.

    Magento finds software to upgrade

  4. Continue with Step 1. Select versions to upgrade.

Error

The following error can indicate one of several issues, including that you haven鈥檛 entered your authentication keys in the Magento Admin:

For suggested solutions to other causes indicated by this message, see troubleshooting.