Skip to main content

Global flags

All KOTS CLI commands support a set of global flags to be used to connect to the cluster.

FlagTypeDescription
--asstringUsername to impersonate for the operation
--as-groupstringArrayGroup to impersonate for the operation, this flag can be repeated to specify multiple groups.
--cache-dirstringDefault HTTP cache directory (default "~/.kube/http-cache")
--certificate-authoritystringPath to a cert file for the certificate authority
--client-certificatestringPath to a client certificate file for TLS
--client-keystringPath to a client key file for TLS
--clusterstringThe name of the kubeconfig cluster to use
--contextstringThe name of the kubeconfig context to use
--insecure-skip-tls-verifyboolIf true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
--kubeconfigstringPath to the kubeconfig file to use for CLI requests.
-n, --namespacestringIf present, the namespace scope for this CLI request
--request-timeoutstringThe 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, --serverstringThe address and port of the Kubernetes API server
--tokenstringBearer token for authentication to the API server
--userstringThe name of the kubeconfig user to use