# How to upgrade Magento v2

> There are two ways to upgrade Magento 2: via the Web Setup Wizard in the admin dashboard, or via SSH using Composer.

Source: https://www.kualo.com/knowledgebase/magento-getting-started/how-to-upgrade-magento-v2
Updated: 2026-06-09

---

![How to upgrade Magento v2](https://kb-cdn.kualo.com/11/41/1141130e0bee76c906b404978f264d1857d9878b.jpg)

There are two ways to upgrade Magento 2: via the **Web Setup Wizard** in the admin dashboard, or via **SSH** using Composer. The Web Setup Wizard is the easier option, so we'll cover that first.

## Web Setup Wizard

Sign in to your Magento admin dashboard, then go to **System > Web Setup Wizard** (under Tools):

![Web Setup Wizard menu](https://kb-cdn.kualo.com/b5/4a/b54ac868187bbeb1324da8d3c65496165da1d072.png)

If this is your first time using the Web Setup Wizard, you will need to provide your Magento Marketplace public and private keys.

1. Go to your [Magento Marketplace](https://marketplace.magento.com/) account page.
2. On the **Access keys** page, copy your public and private keys.
3. Enter the keys in Magento when prompted.
4. Click **System Upgrade**.

Under **Magento Core Components** you will see the currently installed version and the latest version available to upgrade to:

![Magento Core Components version panel](https://kb-cdn.kualo.com/d8/de/d8de69283f5c9fb91b61c90c0bab7c30c08c9f4b.png)

:::info
The **Show All Versions** option includes unstable releases. Skip this if you are upgrading a production site.
:::

**Other Components** lets you upgrade Magento's additional components - modules, libraries, and language packs. Once you have made your selections, click **Next**:

![Component selection screen](https://kb-cdn.kualo.com/df/81/df81b63be52b2a541a2a2ae21e511b7cdbbd31c4.png)

Magento will run a **Readiness Check** to confirm the server environment is ready for the upgrade. If everything passes, proceed to the next step, create a backup, then click **Next** and then **Upgrade**:

![Readiness check and backup screen](https://kb-cdn.kualo.com/eb/d2/ebd2c9f6ec9b66f747230abe47df7191fc593fe3.png)

If you run into problems, make sure your Magento cron jobs are running. You can also refer to the [official Magento documentation](http://devdocs.magento.com/guides/v2.0/comp-mgr/upgrader/upgrade-readiness.html) or [contact us](https://www.kualo.com/company/contact) for assistance.

## SSH with Composer

To upgrade Magento via SSH, connect to the server and navigate to your Magento installation directory.

:::info
If you do not have SSH access enabled, [contact us](https://www.kualo.com/company/contact) and we will help you set it up.
:::

1. Require the target Magento version without running the update yet. Replace `2.x.x` with the version you want to install:

```bash
composer require magento/product-community-edition 2.x.x --no-update
```

2. Run the Composer update. You will be prompted for your Magento Marketplace public key (username) and private key (password) to authenticate against `repo.magento.com`:

```bash
composer update
```

3. Finalise the upgrade by running the setup, compiling, and clearing the cache:

```bash
rm -rf var/generation
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
php bin/magento cache:flush
php bin/magento indexer:reindex
```

If you need any further help, please [contact us](https://www.kualo.com/company/contact).


---

_Source: Kualo Knowledgebase — https://www.kualo.com/knowledgebase/magento-getting-started/how-to-upgrade-magento-v2 · © Kualo Ltd._