OS Manuals

/usr/bin/cilium-certgen

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

From cilium-certgen-fips-0.1 0.1.20-r23 (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 provided Cilium CA certificate file (required if Cilium CA is not generated)
      --ca-common-name string                                          Cilium CA common name (default "Cilium CA")
      --ca-generate                                                    Generate and store Cilium CA certificate
      --ca-key-file string                                             Path to provided Cilium CA key file (required if Cilium CA is not generated)
      --ca-reuse-secret                                                Reuse the Cilium CA secret if it exists, otherwise generate a new one
      --ca-secret-name string                                          Name of the K8s Secret where the Cilium CA cert and key are stored in (default "cilium-ca")
      --ca-secret-namespace string                                     Overwrites the namespace of the K8s Secret where the Cilium CA cert and key are stored in
      --ca-validity-duration duration                                  Cilium CA validity duration (default 26280h0m0s)
      --cilium-namespace string                                        Namespace where the cert secrets and configmaps are stored in (default "kube-system")
      --clustermesh-apiserver-admin-cert-common-name string            clustermesh-apiserver admin certificate common name (default "root")
      --clustermesh-apiserver-admin-cert-generate                      Generate and store clustermesh-apiserver admin certificate
      --clustermesh-apiserver-admin-cert-secret-name string            Name of the K8s Secret where the clustermesh-apiserver admin cert and key are stored in (default "clustermesh-apiserver-admin-cert")
      --clustermesh-apiserver-admin-cert-validity-duration duration    clustermesh-apiserver admin certificate validity duration (default 26280h0m0s)
      --clustermesh-apiserver-client-cert-common-name string           clustermesh-apiserver client certificate common name (default "externalworkload")
      --clustermesh-apiserver-client-cert-generate                     Generate and store clustermesh-apiserver client certificate
      --clustermesh-apiserver-client-cert-secret-name string           Name of the K8s Secret where the clustermesh-apiserver client cert and key are stored in (default "clustermesh-apiserver-client-cert")
      --clustermesh-apiserver-client-cert-validity-duration duration   clustermesh-apiserver client certificate validity duration (default 26280h0m0s)
      --clustermesh-apiserver-remote-cert-common-name string           clustermesh-apiserver remote certificate common name (default "remote")
      --clustermesh-apiserver-remote-cert-generate                     Generate and store clustermesh-apiserver remote certificate
      --clustermesh-apiserver-remote-cert-secret-name string           Name of the K8s Secret where the clustermesh-apiserver remote cert and key are stored in (default "clustermesh-apiserver-remote-cert")
      --clustermesh-apiserver-remote-cert-validity-duration duration   clustermesh-apiserver remote certificate validity duration (default 26280h0m0s)
      --clustermesh-apiserver-server-cert-common-name string           clustermesh-apiserver server certificate common name (default "clustermesh-apiserver.cilium.io")
      --clustermesh-apiserver-server-cert-generate                     Generate and store clustermesh-apiserver server certificate
      --clustermesh-apiserver-server-cert-sans strings                 clustermesh-apiserver server certificate SANs (default [*.mesh.cilium.io])
      --clustermesh-apiserver-server-cert-secret-name string           Name of the K8s Secret where the clustermesh-apiserver server cert and key are stored in (default "clustermesh-apiserver-server-cert")
      --clustermesh-apiserver-server-cert-validity-duration duration   clustermesh-apiserver server certificate validity duration (default 26280h0m0s)
  -D, --debug                                                          Enable debug messages
  -h, --help                                                           help for cilium-certgen
      --hubble-metrics-server-cert-common-name string                  Hubble metrics server certificate common name (default "default.hubble-metrics.cilium.io")
      --hubble-metrics-server-cert-generate                            Generate and store Hubble metrics server certificate
      --hubble-metrics-server-cert-secret-name string                  Name of the K8s Secret where the Hubble metrics server cert and key are stored in (default "hubble-metrics-server-certs")
      --hubble-metrics-server-cert-secret-namespace string             Overwrites the namespace of the K8s Secret where the Hubble metrics server cert and key are stored in
      --hubble-metrics-server-cert-validity-duration duration          Hubble metrics server certificate validity duration (default 26280h0m0s)
      --hubble-relay-client-cert-common-name string                    Hubble Relay client certificate common name (default "*.hubble-relay.cilium.io")
      --hubble-relay-client-cert-generate                              Generate and store Hubble Relay client certificate
      --hubble-relay-client-cert-secret-name string                    Name of the K8s Secret where the Hubble Relay client cert and key are stored in (default "hubble-relay-client-certs")
      --hubble-relay-client-cert-secret-namespace string               Overwrites the namespace of the K8s Secret where the Hubble Relay client cert and key are stored in
      --hubble-relay-client-cert-validity-duration duration            Hubble Relay client certificate validity duration (default 26280h0m0s)
      --hubble-relay-server-cert-common-name string                    Hubble Relay server certificate common name (default "*.hubble-relay.cilium.io")
      --hubble-relay-server-cert-generate                              Generate and store Hubble Relay server certificate
      --hubble-relay-server-cert-secret-name string                    Name of the K8s Secret where the Hubble Relay server cert and key are stored in (default "hubble-relay-server-certs")
      --hubble-relay-server-cert-secret-namespace string               Overwrites the namespace of the K8s Secret where the Hubble Relay server cert and key are stored in
      --hubble-relay-server-cert-validity-duration duration            Hubble Relay server certificate validity duration (default 26280h0m0s)
      --hubble-server-cert-common-name string                          Hubble server certificate common name (default "*.default.hubble-grpc.cilium.io")
      --hubble-server-cert-generate                                    Generate and store Hubble server certificate
      --hubble-server-cert-secret-name string                          Name of the K8s Secret where the Hubble server cert and key are stored in (default "hubble-server-certs")
      --hubble-server-cert-secret-namespace string                     Overwrites the namespace of the K8s Secret where the Hubble server cert and key are stored in
      --hubble-server-cert-validity-duration duration                  Hubble server certificate validity duration (default 26280h0m0s)
      --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 (51)
OptionDescriptionSource
--ca-cert-file stringPath to provided Cilium CA certificate file (required if Cilium CA is not generated)help
--ca-common-name stringCilium CA common name (default "Cilium CA")help
--ca-generateGenerate and store Cilium CA certificatehelp
--ca-key-file stringPath to provided Cilium CA key file (required if Cilium CA is not generated)help
--ca-reuse-secretReuse the Cilium CA secret if it exists, otherwise generate a new onehelp
--ca-secret-name stringName of the K8s Secret where the Cilium CA cert and key are stored in (default "cilium-ca")help
--ca-secret-namespace stringOverwrites the namespace of the K8s Secret where the Cilium CA cert and key are stored inhelp
--ca-validity-duration durationCilium CA validity duration (default 26280h0m0s)help
--cilium-namespace stringNamespace where the cert secrets and configmaps are stored in (default "kube-system")help
--clustermesh-apiserver-admin-cert-common-name stringclustermesh-apiserver admin certificate common name (default "root")help
--clustermesh-apiserver-admin-cert-generateGenerate and store clustermesh-apiserver admin certificatehelp
--clustermesh-apiserver-admin-cert-secret-name stringName of the K8s Secret where the clustermesh-apiserver admin cert and key are stored in (default "clustermesh-apiserver-admin-cert")help
--clustermesh-apiserver-admin-cert-validity-duration durationclustermesh-apiserver admin certificate validity duration (default 26280h0m0s)help
--clustermesh-apiserver-client-cert-common-name stringclustermesh-apiserver client certificate common name (default "externalworkload")help
--clustermesh-apiserver-client-cert-generateGenerate and store clustermesh-apiserver client certificatehelp
--clustermesh-apiserver-client-cert-secret-name stringName of the K8s Secret where the clustermesh-apiserver client cert and key are stored in (default "clustermesh-apiserver-client-cert")help
--clustermesh-apiserver-client-cert-validity-duration durationclustermesh-apiserver client certificate validity duration (default 26280h0m0s)help
--clustermesh-apiserver-remote-cert-common-name stringclustermesh-apiserver remote certificate common name (default "remote")help
--clustermesh-apiserver-remote-cert-generateGenerate and store clustermesh-apiserver remote certificatehelp
--clustermesh-apiserver-remote-cert-secret-name stringName of the K8s Secret where the clustermesh-apiserver remote cert and key are stored in (default "clustermesh-apiserver-remote-cert")help
--clustermesh-apiserver-remote-cert-validity-duration durationclustermesh-apiserver remote certificate validity duration (default 26280h0m0s)help
--clustermesh-apiserver-server-cert-common-name stringclustermesh-apiserver server certificate common name (default "clustermesh-apiserver.cilium.io")help
--clustermesh-apiserver-server-cert-generateGenerate and store clustermesh-apiserver server certificatehelp
--clustermesh-apiserver-server-cert-sans stringsclustermesh-apiserver server certificate SANs (default [*.mesh.cilium.io])help
--clustermesh-apiserver-server-cert-secret-name stringName of the K8s Secret where the clustermesh-apiserver server cert and key are stored in (default "clustermesh-apiserver-server-cert")help
--clustermesh-apiserver-server-cert-validity-duration durationclustermesh-apiserver server certificate validity duration (default 26280h0m0s)help
-D, --debugEnable debug messageshelp
-h, --helphelp for cilium-certgenhelp
--hubble-metrics-server-cert-common-name stringHubble metrics server certificate common name (default "default.hubble-metrics.cilium.io")help
--hubble-metrics-server-cert-generateGenerate and store Hubble metrics server certificatehelp
--hubble-metrics-server-cert-secret-name stringName of the K8s Secret where the Hubble metrics server cert and key are stored in (default "hubble-metrics-server-certs")help
--hubble-metrics-server-cert-secret-namespace stringOverwrites the namespace of the K8s Secret where the Hubble metrics server cert and key are stored inhelp
--hubble-metrics-server-cert-validity-duration durationHubble metrics server certificate validity duration (default 26280h0m0s)help
--hubble-relay-client-cert-common-name stringHubble Relay client certificate common name (default "*.hubble-relay.cilium.io")help
--hubble-relay-client-cert-generateGenerate and store Hubble Relay client certificatehelp
--hubble-relay-client-cert-secret-name stringName of the K8s Secret where the Hubble Relay client cert and key are stored in (default "hubble-relay-client-certs")help
--hubble-relay-client-cert-secret-namespace stringOverwrites the namespace of the K8s Secret where the Hubble Relay client cert and key are stored inhelp
--hubble-relay-client-cert-validity-duration durationHubble Relay client certificate validity duration (default 26280h0m0s)help
--hubble-relay-server-cert-common-name stringHubble Relay server certificate common name (default "*.hubble-relay.cilium.io")help
--hubble-relay-server-cert-generateGenerate and store Hubble Relay server certificatehelp
--hubble-relay-server-cert-secret-name stringName of the K8s Secret where the Hubble Relay server cert and key are stored in (default "hubble-relay-server-certs")help
--hubble-relay-server-cert-secret-namespace stringOverwrites the namespace of the K8s Secret where the Hubble Relay server cert and key are stored inhelp
--hubble-relay-server-cert-validity-duration durationHubble Relay server certificate validity duration (default 26280h0m0s)help
--hubble-server-cert-common-name stringHubble server certificate common name (default "*.default.hubble-grpc.cilium.io")help
--hubble-server-cert-generateGenerate and store Hubble server certificatehelp
--hubble-server-cert-secret-name stringName of the K8s Secret where the Hubble server cert and key are stored in (default "hubble-server-certs")help
--hubble-server-cert-secret-namespace stringOverwrites the namespace of the K8s Secret where the Hubble server cert and key are stored inhelp
--hubble-server-cert-validity-duration durationHubble server certificate validity duration (default 26280h0m0s)help
--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.