---
name: openshift-vpc-migrate-quickstart
title: Migration wizard quickstart guide
description: Use the migration wizard to migrate a Classic cluster to VPC in a guided, end-to-end workflow from the IBM Cloud console.
last-updated: 2026-11-11
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/openshift?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Migration wizard quickstart guide
{: #vpc-migrate-quickstart}
{: toc-content-type="tutorial"}
{: toc-services="openshift"}
{: toc-completion-time="30m"}

[Classic infrastructure]{: tag-classic-inf}

Use the migration wizard to migrate a Classic cluster to VPC in a guided, end-to-end workflow from the IBM Cloud console.
{: shortdesc}

This quickstart shows you how to open the migration wizard and what to expect in each step. For a full explanation of each step, see [Migrating from Classic to VPC](https://cloud.ibm.com/docs/openshift?topic=openshift-vpc-migrate-overview&format=markdown).

## Before you begin
{: #vpc-migrate-quickstart-prereqs}

Make sure that you have the following items.

- A Classic cluster. To check, go to **Containers** > **Clusters** in the [IBM Cloud console](https://cloud.ibm.com/containers/cluster-management/clusters){: external} and confirm that at least one cluster shows **Classic** as the infrastructure type.
- At least the **Operator** (`containers-kubernetes.cluster.operate`) IBM Cloud&reg; Identity and Access Management platform access role for Red Hat OpenShift on IBM Cloud on both the Classic cluster and the VPC cluster. See [Assigning cluster access](https://cloud.ibm.com/docs/openshift?topic=openshift-iam-platform-access-roles&format=markdown).
- An IBM Cloud Object Storage (COS) instance in the same account. The migration service uses COS to store generated metadata and migration plans.
- An IBM Cloud Backup and Recovery Service (BRS) instance in the same account as your Classic cluster. The BRS instance can be in any resource group in that account. BRS is required to migrate workload and storage data.
- [Access your Red Hat OpenShift cluster](https://cloud.ibm.com/docs/openshift?topic=openshift-access_cluster&format=markdown).

## Step 1: Open the migration wizard
{: #vpc-migrate-quickstart-open}

You can open the migration wizard from the Migration hub or from the Containers page. Choose the entry point that you prefer.

### Open the wizard from the Migration hub
{: #vpc-migrate-quickstart-hub}

1. Go to **Migration hub**.
2. Click the **Clusters** tile, or use the navigation to go to **Clusters**.
3. Open **Eligible clusters**.
4. Find your Classic cluster and click **Open wizard**.

### Open the wizard from the Containers page
{: #vpc-migrate-quickstart-containers}

1. Go to **Containers** > **Clusters**.
2. In the row actions for your Classic cluster, select **Migrate to VPC**.

The wizard opens on the **Migrating CLUSTER_NAME** page. The left navigation panel shows your progress through each step.

## Step 2: Follow the migration wizard
{: #vpc-migrate-quickstart-wizard}

Complete the wizard steps in order. The steps in the following table match the steps in the migration wizard.

| Phase | Step | What you do |
|-------|------|-------------|
| Phase 1 | Step 1: Assess | Select a COS instance, run the assessment, and review the proposed VPC configuration. |
| Phase 1 | Step 2: Create | Provision the VPC cluster. Infrastructure migration starts automatically. |
| Phase 1 | Step 3: Migrate | Choose a backup and recovery instance, create migration plans, and move workloads to the VPC cluster, namespace by namespace. |
| Phase 2 | Cutover | Redirect DNS traffic to the VPC cluster, validate your workloads, and complete the finish migration checklist. |
{: caption="Migration wizard phases and steps" caption-side="bottom"}

Cutover and deleting the Classic cluster are manual processes. The migration wizard does not do them for you.
{: important}

## Next steps
{: #vpc-migrate-quickstart-next}

- [Assess your Classic cluster](https://cloud.ibm.com/docs/openshift?topic=openshift-vpc-migrate-assess&format=markdown) and generate the VPC configuration metadata.
- Review [what is and is not migrated automatically](https://cloud.ibm.com/docs/openshift?topic=openshift-vpc-migrate-overview&format=markdown#vpc-migrate-overview-limitations) before you start.
- Prepare for cutover by reading [Cut over and validate](https://cloud.ibm.com/docs/openshift?topic=openshift-vpc-migrate-cutover&format=markdown).