You are viewing documentation for KubeSphere version:v3.0.0

KubeSphere v3.0.0 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Upgrade with ks-installer

ks-installer is recommended for users whose Kubernetes clusters were not set up through the 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, upgrade to v2.1.1 first.

  • Make sure you read Release Notes For 3.0.0 carefully.


    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 if you heavily customized them but not from the console.

Step 1: Download YAML files

Execute the following commands to download configuration templates.


Step 2: Modify the Configuration File

Synchronize the changes from v2.1.1 to v3.0.0 into the configuration 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

Execute the following commands to upgrade KubeSphere.

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