Install: Requirements

This page will guide you through the configuration tweaks needed to unlock kubevirt-manager’s full potential.

---

KubeVirt Feature Gates

To take full advantage of kubevirt-manager, you need to enable a few KubeVirt feature gates that allow advanced functionality:

      featureGates:
      - HotplugVolumes
      - HostDisk
      - VMExport
      - Snapshot
      - ExpandDisks
      - ExperimentalIgnitionSupport
      - LiveMigration

For details on how to enable feature gates, refer to the KubeVirt Documentation.
You can also check the detailed list of feature gates in the KubeVirt source code.

CDI Feature Gates

If you are using hostpath-provisioner CSI, kubevirt-manager requires an additional CDI feature gate to ensure proper functionality:

      featureGates:
      - HonorWaitForFirstConsumer

Details about this feature gate are available in the CDI Repository.

hostpath-provisioner

When using hostpath-provisioner a few more settings are recommended in the StorageClass for proper behavior:

1. Enable volume expansion – This allows resizing of VM disks:
   allowVolumeExpansion: true

2. Set volume binding mode – This ensures proper workload placement on Kubernetes nodes:
   volumeBindingMode: WaitForFirstConsumer

Here is an example of a complete StorageClass for hostpath-provisioner:

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: hostpath-csi
provisioner: kubevirt.io.hostpath-provisioner
reclaimPolicy: Delete
volumeBindingMode: WaitForFirstConsumer
allowVolumeExpansion: true
parameters:
  storagePool: local

For more details, see the Kubernetes docs on Volume Expansion and Volume Binding Modes.