DEV Community


Quickly switch Kubernetes cluster and namespaces with kubectx and kubens

onlyutkarsh profile image Utkarsh Shigihalli Originally published at on ใƒป3 min read

Often when working with Kubernetes you might find yourself switching between your clusters or namespaces. I am doing this numerous times lately and I was slow switching using the regular commands. In this post, I would like to highlight two productivity utilities when working with Kubernetes which will make it simple when working with multiple clusters.

Cluster contexts and namespaces

Kubernetes stores the cluster information in ~/.kube/config file and stores in as a context information. If you are working against multiple clusters ideally you would have different config files and can reference them when running commands with kubectl.

For example, to get pods in different cluster than your default context, you use below command.

kubectl get pods --namespace dev-ns --kubeconfig ~/.kube/devClusterConfig
Enter fullscreen mode Exit fullscreen mode

As you can see, typing namespace information and providing the config for every command is cumbersome.

Merging multiple config files in to one

If you already have multiple config files to connect to different clusters, you would like to merge them first. You can merge both the config file using syntax below

# Merge ~/.kube/config and ~/.kube/devClusterConfig in to new config /tmp/config
$ KUBECONFIG=~/.kube/config:~/.kube/devClusterConfig kubectl config view --flatten > /tmp/config

# Replace old config with new merged config
$ mv /tmp/config ~/.kube/config
Enter fullscreen mode Exit fullscreen mode

Switching the Kubernetes clusters using kubectl commands

Kubernetes already has a concept of contexts and once you merge the config, you will be able to see the contexts information.

$ kubectl config get-contexts
Enter fullscreen mode Exit fullscreen mode

You will see context information as below

* dev-aks-cluster dev-aks-cluster clusterUser_aksdemo_dev-aks-cluster dev-ns
          qa-aks-cluster qa-aks-cluster clusterUser_aksdemo_qa-aks-cluster
Enter fullscreen mode Exit fullscreen mode

You can then switch to the different cluster (in my case its qa-aks-cluster) using below command

$ kubectl config use-context qa-aks-cluster
Enter fullscreen mode Exit fullscreen mode

Switching the namespaces using kubectl commands

Now if you do not want to add --namespace <namespace-name> for every command you type, you can also set it as default namespace for the currently selected context.

kubectl config set-context --current --namespace=<insert-namespace-name-here>
Enter fullscreen mode Exit fullscreen mode

Using kubectx and kubens


kubectx is a great open-source tool to switch clusters. Just type kubectx and it lists the contexts you have. Then you can select one by typing

kubectx dev-aks-cluster
Enter fullscreen mode Exit fullscreen mode

If you have fzf installed, you can also get a nice picker and you can use arrows to select one.

If you keep alternating between contexts, you can also use kubectx - to quickly go back to previous context. Isnโ€™t it cool?

kubectx - Source:


Similar to kubectx, kubens is another great utility from the same creator. It performs pretty much similar to kubectx but lets you switch namespaces. I regularly use this since we have couple of namespaces within our cluster which we deploy to. It has certainly saved me lots of typing.

kubens - Source:


If you are into Kubernetes, both kubectx and kubectl are great productivity tools and will save you lots of time. I certainly am finding them really useful.

Thatโ€™s it for this post, thanks for reading, until next time time ๐Ÿ‘‹๐Ÿผ

Discussion (0)

Editor guide