Difficulty: beginner
Estimated Time: 60


In this scenario you'll learn how to bootstrap KubeSphere in an existing Kubernetes cluster

KubeSphere is also a multi-tenant enterprise-grade open-source Kubernetes container platform with full-stack automated IT operation and streamlined DevOps workflows. It provides developer-friendly wizard web UI, helping enterprises to build out a more robust and feature-rich Kubernetes platform, which includes the most common functionalities needed for enterprise Kubernetes strategies.

More details can be found at https://kubesphere.io/

Install KubeSphere on kubernetes

Step 1 of 2

Step-1 verify Prerequisites

In addition to supporting deploying on VM and BM, KubeSphere also supports installing on cloud-hosted and on-premises existing Kubernetes clusters.


  • Kubernetes Version: 1.17.x, 1.18.x, 1.19.x, 1.20.x;
  • CPU > 1 Core, Memory > 2 G;
  • An existing default Storage Class in your Kubernetes clusters.

1.Make sure your Kubernetes version is compatible by running kubectl version in your cluster node.

Pay attention to Server Version line, if GitVersion is greater than v1.17.0, it's good to go

2.Check if the available resources meet the minimal prerequisite in your cluster. kubectl describe nodes/node01 | grep --color=always "memory:" | tail -1

3.Check if there is a default Storage Class in your cluster.kubectl get sc

No storage Class found in the cluster

controlplane $ kubectl get sc 
No resources found in default namespace.

4.Install openebs storage Class in the cluster

kubectl create namespace openebs
helm repo add openebs https://openebs.github.io/charts
helm repo update
helm install openebs --namespace openebs openebs/openebs --wait

5.Set openebs as a default storage Class for the cluster kubectl patch storageclasses.storage.k8s.io openebs-hostpath -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

6.Check if there is a default Storage Class in your cluster.kubectl get sc

If your Kubernetes cluster environment meets all requirements mentioned above, then you can start to install KubeSphere.