Troubleshooting Guide for Installation

    This guide contains information to help you troubleshoot issues when installing KubeSphere. We summarized the common issues regarding installation on Linux machines or Kubernetes cluster, welcome to contribute your diagnostic conclusions or experience if it is not included in this guide.

    • When you installing KubeSphere or enabling the KubeSphere pluggable components, how to inspect the logs?

    Answer

    Answer

    You can delete the Pod ks-installer or restart the Deployment it to reinstall.

    • Everything seems OK except the “ks-account” Pod that is in “CrashLoopBackOff” mode. The pod fails with . I can display the console login page but can’t login, it fails with”unable to access backend services”.

    KubeSphere uses CSR to issue kubeconfig to each user, that needs extra configuration on kube-apiserver, refer to Managing tls in a cluster. A standard Kubernetes cluster is enabled by default, but it is not enabled on a RKE. So you need to add this manually:

    You can add in the RKE cluster config file the following, see for further information.

    • How to solve this issue like \"ks-openldap\" does not exist as follows when I installing KubeSphere on the existing Kubernetes cluster?

    You can try to change the helm version to , or try to delete openldap using helm del --purge ks-openldap, and restart the Pod using kubectl rollout restart deploy -n kubesphere-system ks-installer.