OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history
×

Deleting virtual machines

You can delete a virtual machine from the web console or by using the oc command-line interface.

Deleting a virtual machine using the web console

Deleting a virtual machine permanently removes it from the cluster.

When you delete a virtual machine, the DataVolume it uses is automatically deleted.
Procedure

  1. In the OpenShift Virtualization console, click Workloads → Virtualization from the side menu.

  2. Click the Virtual Machines tab.

  3. Click the ⋮ button of the virtual machine that you want to delete and select Delete Virtual Machine.

    • Alternatively, click the virtual machine name to open the Virtual Machine Overview screen and click Actions → Delete Virtual Machine.

  4. In the confirmation pop-up window, click Delete to permanently delete the virtual machine.

Deleting a virtual machine by using the CLI

You can delete a virtual machine by using the oc command-line interface (CLI). The oc client enables you to perform actions on multiple virtual machines.

When you delete a virtual machine, the DataVolume it uses is automatically deleted.
Prerequisites

  • Identify the name of the virtual machine that you want to delete.

Procedure

  • Delete the virtual machine by running the following command:

    $ oc delete vm <vm_name>

    This command only deletes objects that exist in the current project. Specify the -n <project_name> option if the object you want to delete is in a different project or namespace.