OS Manuals

/usr/bin/virt-controller

KubeVirt cluster-wide controller managing VirtualMachine and VMI lifecycle

From virt-controller-1.9 1.9.1-r2 (enterprise-packages), captured 2026-11-08 by running virt-controller --help (exit 0). permalink

Also provided by 7 other package versions
Usage of /usr/bin/virt-controller:
      --additional-launcher-annotations-sync strings   Comma separated list of annotation keys which if present on the VM template and so VMI, will be sync to the virt-launcher pod. Supports prefix wildcards via the '*' suffix (for example 'vendor.io/*'). Note, it is unidirectional from VM.spec.template.metadata -> VMI and VMI -> virt-launcher pod
      --additional-launcher-labels-sync strings        Comma separated list of labels keys which if present on the VM template and so VMI, will be sync to the virt-launcher pod. Supports prefix wildcards via the '*' suffix (for example 'vendor.io/*'). Note, it is unidirectional from VM.spec.template.metadata -> VMI and VMI -> virt-launcher pod
      --backup-controller-threads int                  Number of goroutines to run for backup controller (default 6)
      --clone-controller-threads int                   Number of goroutines to run for clone controller (default 3)
      --container-disk-dir string                      Base directory for container disk data (default "/var/run/kubevirt/container-disks")
      --disruption-budget-controller-threads int       Number of goroutines to run for disruption budget controller (default 3)
      --ephemeral-disk-dir string                      Base directory for ephemeral disk data (default "/var/run/kubevirt-ephemeral-disks")
      --evacuation-controller-threads int              Number of goroutines to run for evacuation controller (default 3)
      --export-controller-threads int                  Number of goroutines to run for virtual machine export controller (default 3)
      --exporter-image string                          Container for exporting VMs and VM images (default "virt-exportserver")
      --hotplug-disk-dir string                        Base directory for hotplug disk data (default "/var/run/kubevirt/hotplug-disks")
      --image-pull-secret string                       Secret to use for pulling virt-launcher and/or registry disks
      --kubeconfig string                              absolute path to the kubeconfig file
      --kubevirt-share-dir string                      Shared directory between virt-handler and virt-launcher (default "/var/run/kubevirt")
      --launcher-image string                          Shim container for containerized VMIs (default "virt-launcher")
      --launcher-qemu-timeout int                      Amount of time to wait for qemu (default 240)
      --launcher-subgid int                            ID of subgroup to virt-launcher (default 107)
      --leader-elect-lease-duration duration           The duration that non-leader candidates will wait after observing a leadership renewal until attempting to acquire leadership of a led but unrenewed leader slot. This is effectively the maximum duration that a leader can be stopped before it is replaced by another candidate. This is only applicable if leader election is enabled. (default 15s)
      --leader-elect-renew-deadline duration           The interval between attempts by the acting master to renew a leadership slot before it stops leading. This must be less than or equal to the lease duration. This is only applicable if leader election is enabled. (default 10s)
      --leader-elect-resource-lock endpoints           The type of resource object that is used for locking during leader election. Supported options are endpoints (default) and `configmap`. (default "leases")
      --leader-elect-retry-period duration             The duration the clients should wait between attempting acquisition and renewal of a leadership. This is only applicable if leader election is enabled. (default 2s)
      --listen string                                  Address where to listen on (default "0.0.0.0")
      --master string                                  master url
      --migration-controller-threads int               Number of goroutines to run for migration controller (default 3)
      --node-controller-threads int                    Number of goroutines to run for node controller (default 3)
      --node-topology-update-period duration           Update period for the node topology updater (default 30s)
      --pool-controller-threads int                    Number of goroutines to run for pool controller (default 3)
      --port int                                       Port to listen on (default 8182)
      --prom-cert-file string                          Client certificate used to prove the identity of the virt-controller when it must call out Promethus during a request (default "/etc/virt-controller/certificates/tls.crt")
      --prom-key-file string                           Private key for the client certificate used to prove the identity of the virt-controller when it must call out Promethus during a request (default "/etc/virt-controller/certificates/tls.key")
      --restore-controller-threads int                 Number of goroutines to run for restore controller (default 3)
      --rs-controller-threads int                      Number of goroutines to run for replicaset controller (default 3)
      --snapshot-controller-resync-period duration     Number of goroutines to run for snapshot controller (default 5m0s)
      --snapshot-controller-threads int                Number of goroutines to run for snapshot controller (default 6)
  -v, --v int                                          log level for V logs (default 2)
      --vm-controller-threads int                      Number of goroutines to run for vm controller (default 3)
      --vmi-controller-threads int                     Number of goroutines to run for vmi controller (default 10)
Options (37)
OptionDescriptionSource
--additional-launcher-annotations-sync stringsComma separated list of annotation keys which if present on the VM template and so VMI, will be sync to the virt-launcher pod.help
--additional-launcher-labels-sync stringsComma separated list of labels keys which if present on the VM template and so VMI, will be sync to the virt-launcher pod.help
--backup-controller-threads intNumber of goroutines to run for backup controller (default 6)help
--clone-controller-threads intNumber of goroutines to run for clone controller (default 3)help
--container-disk-dir stringBase directory for container disk data (default "/var/run/kubevirt/container-disks")help
--disruption-budget-controller-threads intNumber of goroutines to run for disruption budget controller (default 3)help
--ephemeral-disk-dir stringBase directory for ephemeral disk data (default "/var/run/kubevirt-ephemeral-disks")help
--evacuation-controller-threads intNumber of goroutines to run for evacuation controller (default 3)help
--export-controller-threads intNumber of goroutines to run for virtual machine export controller (default 3)help
--exporter-image stringContainer for exporting VMs and VM images (default "virt-exportserver")help
--hotplug-disk-dir stringBase directory for hotplug disk data (default "/var/run/kubevirt/hotplug-disks")help
--image-pull-secret stringSecret to use for pulling virt-launcher and/or registry diskshelp
--kubeconfig stringabsolute path to the kubeconfig filehelp
--kubevirt-share-dir stringShared directory between virt-handler and virt-launcher (default "/var/run/kubevirt")help
--launcher-image stringShim container for containerized VMIs (default "virt-launcher")help
--launcher-qemu-timeout intAmount of time to wait for qemu (default 240)help
--launcher-subgid intID of subgroup to virt-launcher (default 107)help
--leader-elect-lease-duration durationThe duration that non-leader candidates will wait after observing a leadership renewal until attempting to acquire leadership of a led but unrenewed leader slot.help
--leader-elect-renew-deadline durationThe interval between attempts by the acting master to renew a leadership slot before it stops leading.help
--leader-elect-resource-lock endpointsThe type of resource object that is used for locking during leader election.help
--leader-elect-retry-period durationThe duration the clients should wait between attempting acquisition and renewal of a leadership.help
--listen stringAddress where to listen on (default "0.0.0.0")help
--master stringmaster urlhelp
--migration-controller-threads intNumber of goroutines to run for migration controller (default 3)help
--node-controller-threads intNumber of goroutines to run for node controller (default 3)help
--node-topology-update-period durationUpdate period for the node topology updater (default 30s)help
--pool-controller-threads intNumber of goroutines to run for pool controller (default 3)help
--port intPort to listen on (default 8182)help
--prom-cert-file stringClient certificate used to prove the identity of the virt-controller when it must call out Promethus during a request (default "/etc/virt-controller/certificates/tls.crt")help
--prom-key-file stringPrivate key for the client certificate used to prove the identity of the virt-controller when it must call out Promethus during a request (default "/etc/virt-controller/certificates/tls.key")help
--restore-controller-threads intNumber of goroutines to run for restore controller (default 3)help
--rs-controller-threads intNumber of goroutines to run for replicaset controller (default 3)help
--snapshot-controller-resync-period durationNumber of goroutines to run for snapshot controller (default 5m0s)help
--snapshot-controller-threads intNumber of goroutines to run for snapshot controller (default 6)help
-v, --v intlog level for V logs (default 2)help
--vm-controller-threads intNumber of goroutines to run for vm controller (default 3)help
--vmi-controller-threads intNumber of goroutines to run for vmi controller (default 10)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.