< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

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 icon in the lower-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.3.2
            kubernetes: v1.22.12
            openpitrix: v3.3.2
          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.

Receive the latest news, articles and updates from KubeSphere

Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.

What’s on this Page