OS Manuals

/usr/bin/webhook-linux-amd64

Automatically provision and manage TLS certificates in Kubernetes

From cert-manager-1.20 1.20.2-r8 (os), captured 2026-11-05 by running webhook-linux-amd64 --help (exit 0). permalink

Also provided by 9 other package versions
cert-manager is a Kubernetes addon to automate the management and issuance of
TLS certificates from various issuing sources.

The webhook component provides API validation, mutation and conversion
functionality for cert-manager.

Usage:
  webhook [flags]

Flags:
      --api-server-host string                               Optional apiserver host address to connect to. If not specified, autoconfiguration will be attempted.
      --client-ca-path string                                The client cert CA used to verify clients contacting webhooks.
      --client-subject-names strings                         One or more client certificate subject names (CN or DNS SAN) that the apiserver may present when contacting the webhook. Should be a comma-separated list.
      --config string                                        Path to a file containing a WebhookConfiguration object used to configure the webhook
      --dynamic-serving-ca-secret-name string                name of the secret used to store the CA that signs serving certificates
      --dynamic-serving-ca-secret-namespace string           namespace of the secret used to store the CA that signs serving certificates
      --dynamic-serving-dns-names strings                    DNS names that should be present on certificates generated by the dynamic serving CA
      --dynamic-serving-leaf-duration duration               leaf duration of serving certificates (default 168h0m0s)
      --enable-client-verification                           Enable client cert authenticate of apiserver to webhooks.
      --enable-profiling                                     Enable profiling for webhook.
      --feature-gates mapStringBool                          A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
                                                             AllAlpha=true|false (ALPHA - default=false)
                                                             AllBeta=true|false (BETA - default=false)
                                                             LiteralCertificateSubject=true|false (BETA - default=true)
                                                             NameConstraints=true|false (BETA - default=true)
                                                             OtherNames=true|false (BETA - default=true)
      --healthz-port int32                                   port number to listen on for insecure healthz connections (default 6080)
  -h, --help                                                 help for webhook
      --kubeconfig string                                    optional path to the kubeconfig used to connect to the apiserver. If not specified, in-cluster-config will be used
      --log-flush-frequency duration                         Maximum number of seconds between log flushes (default 5s)
      --logging-format string                                Sets the log format. Permitted formats: "json" (gated by LoggingBetaOptions), "text". (default "text")
      --metrics-dynamic-serving-ca-secret-name string        name of the secret used to store the CA that signs serving certificates
      --metrics-dynamic-serving-ca-secret-namespace string   namespace of the secret used to store the CA that signs metrics serving certificates
      --metrics-dynamic-serving-dns-names strings            DNS names that should be present on certificates generated by the metrics dynamic serving CA
      --metrics-dynamic-serving-leaf-duration duration       leaf duration of metrics serving certificates (default 168h0m0s)
      --metrics-listen-address string                        The host and port that the metrics endpoint should listen on. The value '0' disables the metrics server (default "0.0.0.0:9402")
      --metrics-tls-cert-file string                         path to the file containing the TLS certificate to serve metrics with
      --metrics-tls-cipher-suites strings                    Comma-separated list of cipher suites for the metrics server. If omitted, the default Go cipher suites will be used.  Possible values: TLS_AES_128_GCM_SHA256,TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_RC4_128_SHA,TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_RC4_128_SHA,TLS_RSA_WITH_3DES_EDE_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_GCM_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA,TLS_RSA_WITH_AES_256_GCM_SHA384,TLS_RSA_WITH_RC4_128_SHA
      --metrics-tls-min-version string                       Minimum TLS version supported by the metrics server. If omitted, the default Go minimum version will be used. Possible values: VersionTLS10, VersionTLS11, VersionTLS12, VersionTLS13
      --metrics-tls-private-key-file string                  path to the file containing the TLS private key to serve metrics with
      --profiler-address string                              Address of the Go profiler (pprof). This should never be exposed on a public interface. If this flag is not set, the profiler is not run. (default "localhost:6060")
      --secure-port int32                                    port number to listen on for secure TLS connections (default 6443)
      --tls-cert-file string                                 path to the file containing the TLS certificate to serve with
      --tls-cipher-suites strings                            Comma-separated list of cipher suites for the server. If omitted, the default Go cipher suites will be used.  Possible values: TLS_AES_128_GCM_SHA256,TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_RC4_128_SHA,TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_RC4_128_SHA,TLS_RSA_WITH_3DES_EDE_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_GCM_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA,TLS_RSA_WITH_AES_256_GCM_SHA384,TLS_RSA_WITH_RC4_128_SHA
      --tls-min-version string                               Minimum TLS version supported. If omitted, the default Go minimum version will be used. Possible values: VersionTLS10, VersionTLS11, VersionTLS12, VersionTLS13
      --tls-private-key-file string                          path to the file containing the TLS private key to serve with
  -v, --v Level                                              number for the log level verbosity
      --vmodule pattern=N,...                                comma-separated list of pattern=N settings for file-filtered logging (only works for text log format)
Options (33)
OptionDescriptionSource
--api-server-host stringOptional apiserver host address to connect to.help
--client-ca-path stringThe client cert CA used to verify clients contacting webhooks.help
--client-subject-names stringsOne or more client certificate subject names (CN or DNS SAN) that the apiserver may present when contacting the webhook.help
--config stringPath to a file containing a WebhookConfiguration object used to configure the webhookhelp
--dynamic-serving-ca-secret-name stringname of the secret used to store the CA that signs serving certificateshelp
--dynamic-serving-ca-secret-namespace stringnamespace of the secret used to store the CA that signs serving certificateshelp
--dynamic-serving-dns-names stringsDNS names that should be present on certificates generated by the dynamic serving CAhelp
--dynamic-serving-leaf-duration durationleaf duration of serving certificates (default 168h0m0s)help
--enable-client-verificationEnable client cert authenticate of apiserver to webhooks.help
--enable-profilingEnable profiling for webhook.help
--feature-gates mapStringBoolA set of key=value pairs that describe feature gates for alpha/experimental features.help
--healthz-port int32port number to listen on for insecure healthz connections (default 6080)help
-h, --helphelp for webhookhelp
--kubeconfig stringoptional path to the kubeconfig used to connect to the apiserver.help
--log-flush-frequency durationMaximum number of seconds between log flushes (default 5s)help
--logging-format stringSets the log format.help
--metrics-dynamic-serving-ca-secret-name stringname of the secret used to store the CA that signs serving certificateshelp
--metrics-dynamic-serving-ca-secret-namespace stringnamespace of the secret used to store the CA that signs metrics serving certificateshelp
--metrics-dynamic-serving-dns-names stringsDNS names that should be present on certificates generated by the metrics dynamic serving CAhelp
--metrics-dynamic-serving-leaf-duration durationleaf duration of metrics serving certificates (default 168h0m0s)help
--metrics-listen-address stringThe host and port that the metrics endpoint should listen on.help
--metrics-tls-cert-file stringpath to the file containing the TLS certificate to serve metrics withhelp
--metrics-tls-cipher-suites stringsComma-separated list of cipher suites for the metrics server.help
--metrics-tls-min-version stringMinimum TLS version supported by the metrics server.help
--metrics-tls-private-key-file stringpath to the file containing the TLS private key to serve metrics withhelp
--profiler-address stringAddress of the Go profiler (pprof).help
--secure-port int32port number to listen on for secure TLS connections (default 6443)help
--tls-cert-file stringpath to the file containing the TLS certificate to serve withhelp
--tls-cipher-suites stringsComma-separated list of cipher suites for the server.help
--tls-min-version stringMinimum TLS version supported.help
--tls-private-key-file stringpath to the file containing the TLS private key to serve withhelp
-v, --v Levelnumber for the log level verbosityhelp
--vmodule pattern=Ncomma-separated list of pattern=N settings for file-filtered logging (only works for text log format)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.