Upgrade with ks-installer

ks-installer is recommended for users whose Kubernetes clusters were not set up via KubeSphere Installer, but hosted by cloud vendors. This tutorial is for upgrading KubeSphere only. Cluster operators are responsible for upgrading Kubernetes themselves beforehand.


  • You need to have a KubeSphere cluster running version 2.1.1.


If your KubeSphere version is v2.1.0 or earlier, please upgrade to v2.1.1 first.


In v3.0.0, KubeSphere refactors many of its components such as Fluent Bit Operator and IAM. Make sure you back up any important components in case you heavily customized them but not from console.

Step 1: Download YAML files

Execute the following commands to download configuration templates.

wget https://raw.githubusercontent.com/kubesphere/ks-installer/v3.0.0/deploy/kubesphere-installer.yaml
wget https://raw.githubusercontent.com/kubesphere/ks-installer/v3.0.0/deploy/cluster-configuration.yaml

Step 2: Modify the configuration file template

Sync the changes from v2.1.1 to v3.0.0 into the config section of cluster-configuration.yaml. Note that the storage class and the pluggable components need to be consistent with that of v2.1.1.

Step 3: Apply YAML files

kubectl apply -f kubesphere-installer.yaml
kubectl apply -f cluster-configuration.yaml