OS Manuals

/usr/bin/agentk

GitLab Agent for Kubernetes allows to integrate your cluster with GitLab in a secure way.

From gitlab-agent-fips-18.9 18.9.7-r0 (enterprise-packages), captured 2026-11-08 by running agentk --help (exit 0). permalink

GitLab Agent for Kubernetes

Usage:
  agentk [flags]

Flags:
      --api-cert-file string                  File with X.509 certificate in PEM format for API endpoint TLS
      --api-client-ca-cert-file string        File with X.509 certificate authority certificate in PEM format. Used for verifying client cert of KAS (GitLab Kubernetes Agent Server). This is used for kas->agentk mTLS
      --api-jwt-file string                   Base64-encoded EdDSA public key to validate JWT tokens from kas. Used for API endpoint
      --api-key-file string                   File with X.509 key in PEM format for API endpoint TLS
      --api-listen-address string             API address to listen on
      --api-listen-network string             API network to listen on (default "tcp")
      --api-mtls                              Used to enabled kas->agentk mTLS. Defaults to true when --api-client-ca-cert-file is specified
      --as string                             Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
      --as-group stringArray                  Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
      --as-uid string                         UID to impersonate for the operation.
      --cache-dir string                      Default cache directory (default "/tmp/.kube/cache")
      --certificate-authority string          Path to a cert file for the certificate authority
      --client-certificate string             Path to a client certificate file for TLS
      --client-key string                     Path to a client key file for TLS
      --cluster string                        The name of the kubeconfig cluster to use
      --context string                        The name of the kubeconfig context to use
      --disable-compression                   If true, opt-out of response compression for all requests to the server
  -h, --help                                  help for agentk
      --insecure-skip-tls-verify              If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
      --kas-address string                    GitLab Kubernetes Agent Server address
      --kas-ca-cert-file string               File with X.509 certificate authority certificate in PEM format. Used for verifying cert of KAS (GitLab Kubernetes Agent Server)
      --kas-header stringArray                HTTP headers to set when connecting to the agent server
      --kas-insecure-skip-tls-verify          If true, the agent server's certificate will not be checked for validity. This will make the connection insecure
      --kas-tls-server-name string            Server name to use for agent server certificate validation. If it is not provided, the hostname used to contact the server is used
      --kubeconfig string                     Path to the kubeconfig file to use for CLI requests.
  -n, --namespace string                      If present, the namespace scope for this CLI request
      --observability-cert-file string        File with X.509 certificate in PEM format for observability endpoint TLS
      --observability-key-file string         File with X.509 key in PEM format for observability endpoint TLS
      --observability-listen-address string   Observability address to listen on (default ":8080")
      --observability-listen-network string   Observability network to listen on (default "tcp")
      --private-api-ca-cert-file string       File with X.509 certificate authority certificate in PEM format for private API endpoint TLS
      --private-api-cert-file string          File with X.509 certificate in PEM format for private API endpoint TLS
      --private-api-jwt-file string           Base64-encoded secret for JWT token creation and validation for agentk to agentk private API access
      --private-api-key-file string           File with X.509 key in PEM format for private API endpoint TLS
      --private-api-listen-address string     Private API address to listen on (default ":8081")
      --private-api-listen-network string     Private API network to listen on (default "tcp")
      --request-timeout string                The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
  -s, --server string                         The address and port of the Kubernetes API server
      --tls-server-name string                Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
      --token string                          Bearer token for authentication to the API server
      --token-file string                     File with access token
      --user string                           The name of the kubeconfig user to use
  -v, --version                               version for agentk
Options (43)
OptionDescriptionSource
--api-cert-file stringFile with X.509 certificate in PEM format for API endpoint TLShelp
--api-client-ca-cert-file stringFile with X.509 certificate authority certificate in PEM format.help
--api-jwt-file stringBase64-encoded EdDSA public key to validate JWT tokens from kas.help
--api-key-file stringFile with X.509 key in PEM format for API endpoint TLShelp
--api-listen-address stringAPI address to listen onhelp
--api-listen-network stringAPI network to listen on (default "tcp")help
--api-mtlsUsed to enabled kas->agentk mTLS.help
--as stringUsername to impersonate for the operation.help
--as-group stringArrayGroup to impersonate for the operation, this flag can be repeated to specify multiple groups.help
--as-uid stringUID to impersonate for the operation.help
--cache-dir stringDefault cache directory (default "/tmp/.kube/cache")help
--certificate-authority stringPath to a cert file for the certificate authorityhelp
--client-certificate stringPath to a client certificate file for TLShelp
--client-key stringPath to a client key file for TLShelp
--cluster stringThe name of the kubeconfig cluster to usehelp
--context stringThe name of the kubeconfig context to usehelp
--disable-compressionIf true, opt-out of response compression for all requests to the serverhelp
-h, --helphelp for agentkhelp
--insecure-skip-tls-verifyIf true, the server's certificate will not be checked for validity.help
--kas-address stringGitLab Kubernetes Agent Server addresshelp
--kas-ca-cert-file stringFile with X.509 certificate authority certificate in PEM format.help
--kas-header stringArrayHTTP headers to set when connecting to the agent serverhelp
--kas-insecure-skip-tls-verifyIf true, the agent server's certificate will not be checked for validity.help
--kas-tls-server-name stringServer name to use for agent server certificate validation.help
--kubeconfig stringPath to the kubeconfig file to use for CLI requests.help
-n, --namespace stringIf present, the namespace scope for this CLI requesthelp
--observability-cert-file stringFile with X.509 certificate in PEM format for observability endpoint TLShelp
--observability-key-file stringFile with X.509 key in PEM format for observability endpoint TLShelp
--observability-listen-address stringObservability address to listen on (default ":8080")help
--observability-listen-network stringObservability network to listen on (default "tcp")help
--private-api-ca-cert-file stringFile with X.509 certificate authority certificate in PEM format for private API endpoint TLShelp
--private-api-cert-file stringFile with X.509 certificate in PEM format for private API endpoint TLShelp
--private-api-jwt-file stringBase64-encoded secret for JWT token creation and validation for agentk to agentk private API accesshelp
--private-api-key-file stringFile with X.509 key in PEM format for private API endpoint TLShelp
--private-api-listen-address stringPrivate API address to listen on (default ":8081")help
--private-api-listen-network stringPrivate API network to listen on (default "tcp")help
--request-timeout stringThe length of time to wait before giving up on a single server request.help
-s, --server stringThe address and port of the Kubernetes API serverhelp
--tls-server-name stringServer name to use for server certificate validation.help
--token stringBearer token for authentication to the API serverhelp
--token-file stringFile with access tokenhelp
--user stringThe name of the kubeconfig user to usehelp
-v, --versionversion for agentkhelp

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