OS Manuals

/usr/bin/cilium-certgen

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

From cilium-certgen-fips-0.2 0.2.4-r22 (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-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 (15)
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-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.