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.


Edit System Resources on the Console

When you install KubeSphere, the workspace system-workspace is created where all KubeSphere system projects and Kubernetes system projects run. To avoid any misoperation on both systems, you are not allowed to edit resources in the workspace directly on the console. However, you can still make adjustments to resources using kubectl.

This tutorial demonstrates how to enable the editing function of system-workspace resources.


Editing resources in system-workspace may cause unexpected results, such as KubeSphere system and node failures, and your business may be affected. Please be extremely careful about the operation.

Edit the Console Configuration

  1. Log in to KubeSphere as admin. Click the hammer icon in the bottom right corner and select Kubectl.

  2. Execute the following command:

    kubectl -n kubesphere-system edit cm ks-console-config
  3. Add the systemWorkspace field under client and save the file.

            kubesphere: v3.0.0
            kubernetes: v1.17.9
            openpitrix: v0.3.5
          enableKubeConfig: true
          systemWorkspace: "$"  # Add this line manually.
  4. Redeploy ks-console by executing the following command and wait for Pods to be recreated.

    kubectl -n kubesphere-system rollout restart deployment ks-console
  5. Refresh the KubeSphere console and you can see that editing buttons in projects in system-workspace appear.

  6. If you want to disable the editing function on the console, delete the field systemWorkspace by following the same steps above.

What’s on this Page