This is a cache of https://docs.okd.io/4.19/virt/managing_vms/virt-list-vms.html. It is a snapshot of the page at 2025-07-05T21:50:59.073+0000.
Listing virtual machines - Managing VMs | Virtualization | OKD 4.19
×

You can list available virtual machines (VMs) by using the web console or the OpenShift cli (oc).

Listing virtual machines by using the cli

You can either list all of the virtual machines (VMs) in your cluster or limit the list to VMs in a specified namespace by using the OpenShift cli (oc).

Prerequisites
  • You have installed the OpenShift cli (oc).

Procedure
  • List all of the VMs in your cluster by running the following command:

    $ oc get vms -A
  • List all of the VMs in a specific namespace by running the following command:

    $ oc get vms -n <namespace>

Listing virtual machines by using the web console

You can list all of the virtual machines (VMs) in your cluster by using the web console.

Procedure
  1. click VirtualizationVirtualMachines from the side menu to access the tree view with all of the projects and VMs in your cluster.

  2. Optional: Enable the Show only projects with VirtualMachines option above the tree view to limit the displayed projects.

  3. Optional: click the Advanced search button next to the search bar to further filter VMs by one of the following: their name, the project they belong to, their labels, or the allocated vCPU and memory resources.

Organizing virtual machines by using the web console

In addition to creating virtual machines (VMs) in different projects, you can use the tree view to further organize them in folders.

Procedure
  1. click VirtualizationVirtualMachines from the side menu to access the tree view with all projects and VMs in your cluster.

  2. Perform one of the following actions depending on your use case:

    • To move the VM to a new folder in the same project:

      1. Right-click the name of the VM in the tree view.

      2. Select Move to folder from the menu.

      3. Type the name of the folder to create in the "Search folder" bar.

      4. click Create folder in the drop-down list.

      5. click Save.

    • To move the VM to an existing folder in the same project:

      • click the name of the VM in the tree view and drag it to a folder in the same project. If the operation is permitted, the folder is highlighted in green when you drag the VM over it.

    • To move the VM from a folder to the project:

      • click the name of the VM in the tree view and drag it on the project name. If the operation is permitted, the project name is highlighted in green when you drag the VM over it.