Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
IMPORTANT: When upgrading from older version of Dashboard to 1.7+ make sure to delete Cluster Role Binding for
kubernetes-dashboard Service Account, otherwise Dashboard will have full admin access to the cluster.
The fastest way of deploying Dashboard has been described in our README. It is destined for people that are new to Kubernetes and want to quickly start using Dashboard. Other possible setups for more experienced users, that want to know more about our deployment procedure can be found below.
To access Dashboard directly (without
kubectl proxy) valid certificates should be used to establish a secure HTTPS connection. They can be generated using public trusted Certificate Authorities like Let's Encrypt. Use them to replace the auto-generated certificates from Dashboard.
By default self-signed certificates are generated and stored in-memory. In case you would like to use your custom certificates follow the below steps, otherwise skip directly to the Dashboard deploy part.
Custom certificates have to be stored in a secret named
namespace. Assuming that you have
dashboard.key files stored under
you should create secret with contents of these files:
kubectl create secret generic kubernetes-dashboard-certs --from-file=$HOME/certs -n kube-system
Afterwards, you are ready to deploy Dashboard using the following command:
kubectl create -f https://raw.githubusercontent.com/kubernetes/dashboard/v1.10.1/src/deploy/recommended/kubernetes-dashboard.yaml
This setup is not fully secure. Certificates are not used and Dashboard is exposed only over HTTP. In this setup access control can be ensured only by using Authorization Header feature.
To deploy Dashboard execute following command:
kubectl create -f https://raw.githubusercontent.com/kubernetes/dashboard/v1.10.1/src/deploy/alternative/kubernetes-dashboard.yaml
Besides official releases, there are also development releases, that are pushed after every successful master build. It is not advised to use them on production environment as they are less stable than the official ones. Following sections describe installation and discovery of development releases.
In most of the use cases you need to execute the following command to deploy latest development release:
$ kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/master/aio/deploy/recommended/kubernetes-dashboard-head.yaml
You can also deploy dashboard on ARM-based clusters:
$ kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/master/aio/deploy/recommended/kubernetes-dashboard-arm-head.yaml
Once installed, the deployment is not automatically updated. In order to update it you need to delete the deployment's pods and wait for it to be recreated. After recreation, it should use the latest image.
Delete all Dashboard pods (assuming that Dashboard is deployed in
$ kubectl -n kube-system delete $(kubectl -n kube-system get pod -o name | grep dashboard) pod "kubernetes-dashboard-3313488171-7706x" deleted pod "kubernetes-dashboard-3313488171-ddkqd" deleted pod "kubernetes-dashboard-3313488171-dpf9t" deleted pod "kubernetes-dashboard-3313488171-jdz1n" deleted pod "kubernetes-dashboard-3313488171-sxc9n" deleted