I am new to kubernetes. The default cluster name is Kubernetes and I want to rename it to something more meaningful. Can anybody help?

2 Answers 2


You can change the name of a Kubernetes cluster by editing the cluster's configuration file, usually located at /etc/kubernetes/manifests/kube-apiserver.yaml.

Find the --cluster-name flag in the file and replace its current value with the desired name. After making the change, you will need to restart the kube-apiserver service to apply the changes.


To rename a Kubernetes cluster, you need to update the cluster name in the cluster's API server configuration. Here are the steps to do this:

  1. Stop the API server:
kubectl drain <node-name> --ignore-daemonsets
kubectl delete node <node-name>
  1. Edit the API server configuration file:
sudo nano /etc/kubernetes/manifests/kube-apiserver.yaml
  1. Locate the following line:
    - --cluster-name=kubernetes
  1. Change the kubernetes to your desired name, for example:
    - --cluster-name=my-cluster-name
  1. Save and close the file.

  2. Restart the API server:

kubectl create -f /etc/kubernetes/manifests/kube-apiserver.yaml
  1. Verify the change by running the following command:
kubectl config current-context

This should show the updated cluster name in the output.

Note: The above steps assume you are running a self-hosted Kubernetes cluster. If you are using a managed Kubernetes service, the steps may differ.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .