OS Manuals

/usr/bin/cilium-certgen

A convenience tool to generate and store certificates for Hubble Relay mTLS.

From cilium-certgen-fips-0.4 0.4.13-r0 (enterprise-packages), captured 2026-11-08 by running cilium-certgen --help (exit 0). permalink

cilium-certgen bootstraps TLS certificates and stores them as K8s secrets

Usage:
  cilium-certgen [flags]

Flags:
      --ca-cert-file string                              Path to the provided CA certificate file (required if the CA is not generated)
      --ca-common-name string                            CA common name (default "CA")
      --ca-configmap-name string                         Name of the K8s ConfigMap where the CA cert are stored in
      --ca-configmap-namespace string                    Namespace of the K8s ConfigMap where the CA cert are stored in
      --ca-enforce-validity-throughout-leaves-duration   Enforce that the CA certificates remain valid for the entire duration of the requested leaf certificates
      --ca-generate                                      Generate and store the CA certificate
      --ca-key-file string                               Path to the provided CA key file (required if the CA is not generated)
      --ca-reuse-secret                                  Reuse the CA secret if it exists, otherwise generate a new one
      --ca-secret-name string                            Name of the K8s Secret where the CA cert and key are stored in (default "ca")
      --ca-secret-namespace string                       Namespace of the K8s Secret where the CA cert and key are stored in (default "kube-system")
      --ca-validity-duration duration                    CA validity duration (default 26280h0m0s)
      --config string                                    YAML configuration of the certificates to generate, takes precedence over config-file
      --config-file string                               Path to the file containing the YAML configuration of the certificates to generate
  -D, --debug                                            Enable debug messages
  -h, --help                                             help for cilium-certgen
      --k8s-kubeconfig-path string                       Path to the K8s kubeconfig file. If absent, the in-cluster config is used.
      --k8s-request-timeout duration                     Timeout for K8s API requests (default 1m0s)
  -v, --version                                          version for cilium-certgen
Options (18)
OptionDescriptionSource
--ca-cert-file stringPath to the provided CA certificate file (required if the CA is not generated)help
--ca-common-name stringCA common name (default "CA")help
--ca-configmap-name stringName of the K8s ConfigMap where the CA cert are stored inhelp
--ca-configmap-namespace stringNamespace of the K8s ConfigMap where the CA cert are stored inhelp
--ca-enforce-validity-throughout-leaves-durationEnforce that the CA certificates remain valid for the entire duration of the requested leaf certificateshelp
--ca-generateGenerate and store the CA certificatehelp
--ca-key-file stringPath to the provided CA key file (required if the CA is not generated)help
--ca-reuse-secretReuse the CA secret if it exists, otherwise generate a new onehelp
--ca-secret-name stringName of the K8s Secret where the CA cert and key are stored in (default "ca")help
--ca-secret-namespace stringNamespace of the K8s Secret where the CA cert and key are stored in (default "kube-system")help
--ca-validity-duration durationCA validity duration (default 26280h0m0s)help
--config stringYAML configuration of the certificates to generate, takes precedence over config-filehelp
--config-file stringPath to the file containing the YAML configuration of the certificates to generatehelp
-D, --debugEnable debug messageshelp
-h, --helphelp for cilium-certgenhelp
--k8s-kubeconfig-path stringPath to the K8s kubeconfig file.help
--k8s-request-timeout durationTimeout for K8s API requests (default 1m0s)help
-v, --versionversion for cilium-certgenhelp

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