# kubectl config

kubectl configSynopsisModify kubeconfig files using subcommands like "kubectl config set current-context my-context".The loading order follows these rules:If the --kubeconfig flag is set, then only that file is loaded. The flag may only be set once and no merging takes place.If $KUBECONFIG environment variable is set, then it is used as a list of paths (normal path delimiting rules for your system). These paths are merged. When a value is modified, it is modified in the file that defines the stanza. When a value is created, it is created in the first file that exists. If no files in the chain exist, then it creates the last file in the list.Otherwise, ${HOME}/.kube/config is used and no merging takes place.kubectl config SUBCOMMAND Options-h, --helphelp for config--kubeconfig stringuse a particular kubeconfig fileParent Options Inherited--as stringUsername to impersonate for the operation. User could be a regular user or a service account in a namespace.--as-group stringsGroup to impersonate for the operation, this flag can be repeated to specify multiple groups.--as-uid stringUID to impersonate for the operation.--cache-dir string Default: "$HOME/.kube/cache"Default cache directory--certificate-authority stringPath to a cert file for the certificate authority--client-certificate stringPath to a client certificate file for TLS--client-key stringPath to a client key file for TLS--cluster stringThe name of the kubeconfig cluster to use--context stringThe name of the kubeconfig context to use--disable-compressionIf true, opt-out of response compression for all requests to the server--insecure-skip-tls-verifyIf true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure--kuberc stringPath to the kuberc file to use for preferences. This can be disabled by exporting KUBECTL_KUBERC=false feature gate or turning off the feature KUBERC=off.--match-server-versionRequire server version to match client version-n, --namespace stringIf present, the namespace scope for this CLI request--password stringPassword for basic authentication to the API server--profile string Default: "none"Name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex)--profile-output string Default: "profile.pprof"Name of the file to write the profile to--request-timeout string Default: "0"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.-s, --server stringThe address and port of the Kubernetes API server--storage-driver-buffer-duration duration Default: 1m0sWrites in the storage driver will be buffered for this duration, and committed to the non memory backends as a single transaction--storage-driver-db string Default: "cadvisor"database name--storage-driver-host string Default: "localhost:8086"database host:port--storage-driver-password string Default: "root"database password--storage-driver-secureuse secure connection with database--storage-driver-table string Default: "stats"table name--storage-driver-user string Default: "root"database username--tls-server-name stringServer name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used--token stringBearer token for authentication to the API server--user stringThe name of the kubeconfig user to use--username stringUsername for basic authentication to the API server--version version[=true]--version, --version=raw prints version information and quits; --version=vX.Y.Z... sets the reported version--warnings-as-errorsTreat warnings received from the server as errors and exit with a non-zero exit codeSee Alsokubectl - kubectl controls the Kubernetes cluster managerkubectl config current-context - Display the current-contextkubectl config delete-cluster - Delete the specified cluster from the kubeconfigkubectl config delete-context - Delete the specified context from the kubeconfigkubectl config delete-user - Delete the specified user from the kubeconfigkubectl config get-clusters - Display clusters defined in the kubeconfigkubectl config get-contexts - Describe one or many contextskubectl config get-users - Display users defined in the kubeconfigkubectl config rename-context - Rename a context from the kubeconfig filekubectl config set - Set an individual value in a kubeconfig filekubectl config set-cluster - Set a cluster entry in kubeconfigkubectl config set-context - Set a context entry in kubeconfigkubectl config set-credentials - Set a user entry in kubeconfigkubectl config unset - Unset an individual value in a kubeconfig filekubectl config use-context - Set the current-context in a kubeconfig filekubectl config view - Display merged kubeconfig settings or a specified kubeconfig fileThis page is automatically generated.If you plan to report an issue with this page, mention that the page is auto-generated in your issue description. The fix may need to happen elsewhere in the Kubernetes project.