Install OpenShift Virtualization to add virtualization functionality to your OpenShift Container Platform cluster.

You can use the OpenShift Container Platform 4.5 web console to subscribe to and deploy the OpenShift Virtualization Operators.


  • Install OpenShift Container Platform 4.5 on your cluster.

  • Log in as a user with cluster-admin permissions.

Subscribing to the OpenShift Virtualization catalog

Before you install OpenShift Virtualization, subscribe to the OpenShift Virtualization catalog from the OpenShift Container Platform web console. Subscribing gives the openshift-cnv namespace access to the OpenShift Virtualization Operators.

  1. Open a browser window and log in to the OpenShift Container Platform web console.

  2. Navigate to the OperatorsOperatorHub page.

  3. Search for OpenShift Virtualization and then select it.

  4. Read the information about the Operator and click Install.

  5. On the Create Operator Subscription page:

    1. For Installed Namespace, ensure that the Operator recommended namespace option is selected. This installs the Operator in the mandatory openshift-cnv namespace, which is automatically created if it does not exist.

      Attempting to install the OpenShift Virtualization Operator in a namespace other than openshift-cnv causes the installation to fail.

    2. Select 2.4 from the list of available Update Channel options.

    3. For Approval Strategy, ensure that Automatic, which is the default value, is selected. OpenShift Virtualization automatically updates when a new z-stream release is available.

  6. Click Subscribe to make the Operator available to the openshift-cnv namespace.

    On the Installed Operators screen, the Status displays Succeeded when OpenShift Virtualization finishes installation.

Deploying OpenShift Virtualization

After subscribing to the OpenShift Virtualization catalog, create the CNV Operator Deployment custom resource to deploy OpenShift Virtualization.

  • An active subscription to the OpenShift Virtualization catalog in the openshift-cnv namespace

  1. Navigate to the OperatorsInstalled Operators page.

  2. Click OpenShift Virtualization.

  3. Click the CNV Operator Deployment tab and click Create HyperConverged Cluster.

    To avoid deployment errors, do not rename the custom resource. Before you proceed to the next step, ensure that the custom resource is named the default kubevirt-hyperconverged.

  4. Click Create to launch OpenShift Virtualization.

  5. Navigate to the WorkloadsPods page and monitor the OpenShift Virtualization Pods until they are all Running. After all the Pods display the Running state, you can access OpenShift Virtualization.