OS Manuals

/usr/bin/virt-controller

KubeVirt cluster-wide controller managing VirtualMachine and VMI lifecycle

From virt-controller-1.6 1.6.6-r12 (enterprise-packages), captured 2026-11-08 by running virt-controller --help (exit 2). permalink

Usage of /usr/bin/virt-controller:
      --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)
      --dra-status-controller-threads int            Number of goroutines to run for dra status 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)
pflag: help requested
Options (35)
OptionDescriptionSource
--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
--dra-status-controller-threads intNumber of goroutines to run for dra status 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.