Usage of /usr/bin/cleanup-controller:
-add_dir_header
If true, adds the file directory to the header of the log messages
-allowHTTPInNamespacedPolicies value
Set to 'true' to enable CEL http.Get/Post in namespaced policies. Disabled by default due to SSRF risk (CVE-2026-4789); enable only when combined with restrictive network policies.
-alsologtostderr
log to standard error as well as files (no effect when -logtostderr=true)
-alsologtostderrthreshold value
logs at or above this threshold go to stderr when -alsologtostderr=true (no effect when -logtostderr=true)
-apiCallTimeout duration
Timeout for HTTP API calls made by policies. A value of 0 means no timeout. (default 30s)
-autoDeleteWebhooks
Set this flag to 'true' to enable autodeletion of webhook configurations using finalizers (requires extra permissions).
-autoMemLimitEnabled
Enable automatic GOMEMLIMIT configuration based on container or system memory. (default true)
-autoMemLimitRatio float
The ratio of reserved GOMEMLIMIT memory to the detected maximum container or system memory. Must be greater than 0 and less than or equal to 1. (default 0.9)
-caSecretName string
Name of the secret containing CA.
-cleanupServerHost string
Host used by the cleanup server. If not set, it will default to [::] for IPv6 or 0.0.0.0 for IPv4.
-cleanupServerPort int
kyverno cleanup server port, defaults to '9443'. (default 9443)
-clientRateLimitBurst int
Configure the maximum burst for throttle. Uses the client default if zero. (default 200)
-clientRateLimitQPS float
Configure the maximum QPS to the Kubernetes API server from Kyverno. Uses the client default if zero. (default 100)
-crdWatcher
Enable watching of custom resources to invalidate discovery cache on changes.
-disableLogColor
Disable colored output in logs.
-disableMetrics
Set this flag to 'true' to disable metrics.
-dumpPayload
Set this flag to activate/deactivate debug mode.
-enableConfigMapCaching
Enable config maps caching. (default true)
-enableDeferredLoading value
enable deferred loading of context variables
-enableTracing
Set this flag to 'true', to enable tracing.
-eventsRateLimitBurst int
Configure the maximum burst for throttle for events. Uses the client default if zero. (default 2000)
-eventsRateLimitQPS float
Configure the maximum QPS to the Kubernetes API server from Kyverno for events. Uses the client default if zero. (default 1000)
-exemplarFilter string
Configure the exemplar filter for metrics. Supported values: always-off, trace-based, always-on. Default is trace-based (exemplars collected from sampled traces). (default "trace-based")
-httpAllowlist value
Comma-separated list of URL prefixes (scheme+host[+path]) permitted in CEL http.Get/Post calls. When set, only matching URLs are allowed. Example: 'https://api.example.com,https://webhook.corp/v1/'.
-httpBlocklist value
Comma-separated list of CIDR ranges or hostnames blocked from CEL http.Get/Post calls. Overrides the built-in defaults when set. Example: '10.0.0.0/8,metadata.google.internal'.
-kubeconfig string
Path to a kubeconfig. Only required if out-of-cluster.
-leaderElectionRetryPeriod duration
Configure leader election retry period. (default 2s)
-legacy_stderr_threshold_behavior
If true, stderrthreshold is ignored when logtostderr=true (legacy behavior). If false, stderrthreshold is honored even when logtostderr=true (default true)
-log_backtrace_at value
when logging hits line file:N, emit a stack trace
-log_dir string
If non-empty, write log files in this directory (no effect when -logtostderr=true)
-log_file string
If non-empty, use this log file (no effect when -logtostderr=true)
-log_file_max_size uint
Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
-loggingFormat string
This determines the output format of the logger. (default "text")
-loggingtsFormat string
This determines the timestamp format of the logger. (default "default")
-logtostderr
log to standard error instead of files (default true)
-maxAPICallResponseLength int
Maximum allowed response size from API Calls. A value of 0 bypasses checks (not recommended). (default 2000000)
-maxQueuedEvents int
Maximum events to be queued. (default 1000)
-metricsCASecretName string
The secret name which contains the CA certificate for the metrics endpoint.
-metricsHost string
Expose prometheus metrics at the given host. If not set, it will default to [::] for IPv6 or 0.0.0.0 for IPv4.
-metricsKeyAlgorithm string
Set this flag to the key algorithm used for self-signed TLS certificates for the metrics endpoint. Supported values: RSA, ECDSA, Ed25519. (default "RSA")
-metricsPort int
Expose prometheus metrics at the given port, default to 8000. (default 8000)
-metricsRenewBefore duration
The certificate renewal time before expiration for metrics TLS certificates. (default 360h0m0s)
-metricsServerIP string
IP address where metrics server runs. Used to add IP addresses to the metrics TLS certificate SANs. Only required if accessing metrics endpoint out-of-cluster by IP address.
-metricsTLSSecretName string
The secret name which contains the TLS certs for the metrics endpoint.
-one_output
If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
-otelCollector string
Set this flag to the OpenTelemetry Collector Service Address. Kyverno will try to connect to this on the metrics port. (default "opentelemetrycollector.kyverno.svc.cluster.local")
-otelConfig string
Set this flag to 'grpc', to enable exporting metrics to an Opentelemetry Collector. The default collector is set to "prometheus" (default "prometheus")
-profile
Set this flag to 'true', to enable profiling.
-profileAddress string
Profiling server address, defaults to ''.
-profilePort string
Profiling server port, defaults to '6060'. (default "6060")
-protectManagedResources value
Set the flag to 'true', to enable managed resources protection.
-renewBefore duration
The certificate renewal time before expiration (default 360h0m0s)
-resyncPeriod duration
Configure the resync period for informer factory (default 15m0s)
-serverIP string
IP address where Kyverno controller runs. Only required if out-of-cluster.
-servicePort int
Port used by the Kyverno Service resource and for webhook configurations. (default 443)
-skip_headers
If true, avoid header prefixes in the log messages
-skip_log_headers
If true, avoid headers when opening log files (no effect when -logtostderr=true)
-stderrthreshold value
logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true unless -legacy_stderr_threshold_behavior=false) (default 2)
-tlsKeyAlgorithm string
Key algorithm for self-signed TLS certificates (RSA, ECDSA, Ed25519) (default "RSA")
-tlsSecretName string
Name of the secret containing TLS pair.
-tracingAddress string
Tracing receiver address, defaults to ''.
-tracingCreds string
Set this flag to the CA secret containing the certificate which is used by our Opentelemetry Tracing Client. If empty string is set, means an insecure connection will be used
-tracingPort string
Tracing receiver port, defaults to '4317'. (default "4317")
-transportCreds string
Set this flag to the CA secret containing the certificate which is used by our Opentelemetry Metrics Client. If empty string is set, means an insecure connection will be used
-ttlReconciliationInterval duration
Set this flag to set the interval after which the resource controller reconciliation should occur (default 1m0s)
-v value
number for the log level verbosity
-vmodule value
comma-separated list of pattern=N settings for file-filtered logging
-webhookServerPort int
Port used by the webhook server. (deprecated: replaced by --cleanupServerPort) (default 9443)
Options (68)
| Option | Description | Source |
|---|---|---|
-add_dir_header | If true, adds the file directory to the header of the log messages | help |
-allowHTTPInNamespacedPolicies value | Set to 'true' to enable CEL http.Get/Post in namespaced policies. | help |
-alsologtostderr | log to standard error as well as files (no effect when -logtostderr=true) | help |
-alsologtostderrthreshold value | logs at or above this threshold go to stderr when -alsologtostderr=true (no effect when -logtostderr=true) | help |
-apiCallTimeout duration | Timeout for HTTP API calls made by policies. | help |
-autoDeleteWebhooks | Set this flag to 'true' to enable autodeletion of webhook configurations using finalizers (requires extra permissions). | help |
-autoMemLimitEnabled | Enable automatic GOMEMLIMIT configuration based on container or system memory. | help |
-autoMemLimitRatio float | The ratio of reserved GOMEMLIMIT memory to the detected maximum container or system memory. | help |
-caSecretName string | Name of the secret containing CA. | help |
-cleanupServerHost string | Host used by the cleanup server. | help |
-cleanupServerPort int | kyverno cleanup server port, defaults to '9443'. | help |
-clientRateLimitBurst int | Configure the maximum burst for throttle. | help |
-clientRateLimitQPS float | Configure the maximum QPS to the Kubernetes API server from Kyverno. | help |
-crdWatcher | Enable watching of custom resources to invalidate discovery cache on changes. | help |
-disableLogColor | Disable colored output in logs. | help |
-disableMetrics | Set this flag to 'true' to disable metrics. | help |
-dumpPayload | Set this flag to activate/deactivate debug mode. | help |
-enableConfigMapCaching | Enable config maps caching. | help |
-enableDeferredLoading value | enable deferred loading of context variables | help |
-enableTracing | Set this flag to 'true', to enable tracing. | help |
-eventsRateLimitBurst int | Configure the maximum burst for throttle for events. | help |
-eventsRateLimitQPS float | Configure the maximum QPS to the Kubernetes API server from Kyverno for events. | help |
-exemplarFilter string | Configure the exemplar filter for metrics. | help |
-httpAllowlist value | Comma-separated list of URL prefixes (scheme+host[+path]) permitted in CEL http.Get/Post calls. | help |
-httpBlocklist value | Comma-separated list of CIDR ranges or hostnames blocked from CEL http.Get/Post calls. | help |
-kubeconfig string | Path to a kubeconfig. | help |
-leaderElectionRetryPeriod duration | Configure leader election retry period. | help |
-legacy_stderr_threshold_behavior | If true, stderrthreshold is ignored when logtostderr=true (legacy behavior). | help |
-log_backtrace_at value | when logging hits line file:N, emit a stack trace | help |
-log_dir string | If non-empty, write log files in this directory (no effect when -logtostderr=true) | help |
-log_file string | If non-empty, use this log file (no effect when -logtostderr=true) | help |
-log_file_max_size uint | Defines the maximum size a log file can grow to (no effect when -logtostderr=true). | help |
-loggingFormat string | This determines the output format of the logger. | help |
-loggingtsFormat string | This determines the timestamp format of the logger. | help |
-logtostderr | log to standard error instead of files (default true) | help |
-maxAPICallResponseLength int | Maximum allowed response size from API Calls. | help |
-maxQueuedEvents int | Maximum events to be queued. | help |
-metricsCASecretName string | The secret name which contains the CA certificate for the metrics endpoint. | help |
-metricsHost string | Expose prometheus metrics at the given host. | help |
-metricsKeyAlgorithm string | Set this flag to the key algorithm used for self-signed TLS certificates for the metrics endpoint. | help |
-metricsPort int | Expose prometheus metrics at the given port, default to 8000. | help |
-metricsRenewBefore duration | The certificate renewal time before expiration for metrics TLS certificates. | help |
-metricsServerIP string | IP address where metrics server runs. | help |
-metricsTLSSecretName string | The secret name which contains the TLS certs for the metrics endpoint. | help |
-one_output | If true, only write logs to their native severity level (vs also writing to each lower severity level; | help |
-otelCollector string | Set this flag to the OpenTelemetry Collector Service Address. | help |
-otelConfig string | Set this flag to 'grpc', to enable exporting metrics to an Opentelemetry Collector. | help |
-profile | Set this flag to 'true', to enable profiling. | help |
-profileAddress string | Profiling server address, defaults to ''. | help |
-profilePort string | Profiling server port, defaults to '6060'. | help |
-protectManagedResources value | Set the flag to 'true', to enable managed resources protection. | help |
-renewBefore duration | The certificate renewal time before expiration (default 360h0m0s) | help |
-resyncPeriod duration | Configure the resync period for informer factory (default 15m0s) | help |
-serverIP string | IP address where Kyverno controller runs. | help |
-servicePort int | Port used by the Kyverno Service resource and for webhook configurations. | help |
-skip_headers | If true, avoid header prefixes in the log messages | help |
-skip_log_headers | If true, avoid headers when opening log files (no effect when -logtostderr=true) | help |
-stderrthreshold value | logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true unless -legacy_stderr_threshold_behavior=false) (default 2) | help |
-tlsKeyAlgorithm string | Key algorithm for self-signed TLS certificates (RSA, ECDSA, Ed25519) (default "RSA") | help |
-tlsSecretName string | Name of the secret containing TLS pair. | help |
-tracingAddress string | Tracing receiver address, defaults to ''. | help |
-tracingCreds string | Set this flag to the CA secret containing the certificate which is used by our Opentelemetry Tracing Client. | help |
-tracingPort string | Tracing receiver port, defaults to '4317'. | help |
-transportCreds string | Set this flag to the CA secret containing the certificate which is used by our Opentelemetry Metrics Client. | help |
-ttlReconciliationInterval duration | Set this flag to set the interval after which the resource controller reconciliation should occur (default 1m0s) | help |
-v value | number for the log level verbosity | help |
-vmodule value | comma-separated list of pattern=N settings for file-filtered logging | help |
-webhookServerPort int | Port used by the webhook server. | help |