Eclipse Che logo Eclipse Che Documentation
Home Blog Source Code

Documentation

    • Introduction to Che
    • Eclipse Che hosted by Red Hat
      • Try in Web IDE GitHub action
  • User Guide
    • Adopting Che
      • Developer workspaces
      • Stack samples
      • Badge for first-time contributors
      • Reviewing pull and merge requests
    • User onboarding
      • Starting a new workspace with a clone of a Git repository
      • Optional parameters for the URLs for starting a new workspace
        • URL parameter concatenation
        • URL parameter for the workspace IDE
        • URL parameter for starting duplicate workspaces
        • URL parameter for the devfile file name
        • URL parameter for the devfile file path
        • URL parameter for the workspace storage
        • URL parameter for additional remotes
      • Basic actions you can perform on a workspace
      • Authenticating to a Git server from a workspace
    • Customizing workspace components
    • Introduction to devfile in Che
    • Selecting a workspace IDE
      • Selecting an in-browser IDE for one new workspace
      • Selecting an in-browser IDE for all workspaces that clone the same Git repository
    • Using credentials and configurations in workspaces
      • Mounting Secrets
        • Creating image pull Secrets
        • Using a Git-provider access token
      • Mounting ConfigMaps
      • Enabling artifact repositories in a restricted environment
        • Maven
        • Gradle
        • npm
        • Python
        • Go
        • NuGet
    • Requesting persistent storage for workspaces
    • Integrating with Kubernetes
      • Automatic Kubernetes token injection
      • Navigating Che from OpenShift Developer Perspective
      • Navigating OpenShift web console from Che
    • Troubleshooting Che
      • Viewing Che workspaces logs
        • Workspace logs in CLI
        • Workspace logs in OpenShift console
        • Language servers and debug adapters logs in the editor
      • Troubleshooting workspace start failures
      • Troubleshooting slow workspaces
      • Troubleshooting network problems
  • Administration Guide
    • Preparing the installation
      • Supported platforms
      • Architecture
        • Server components
          • Che operator
          • Dev Workspace operator
          • Gateway
          • User dashboard
          • Devfile registries
          • Che server
          • PostgreSQL
          • Plug-in registry
        • User workspaces
      • Calculating Che resource requirements
    • Installing Che
      • Installing the chectl management tool
      • Installing Che on OpenShift using CLI
      • Installing Che on OpenShift using the web console
      • Installing Che in a restricted environment
      • Installing Che locally
        • Installing Che on Red Hat OpenShift Local
        • Installing Che on Minikube
        • Installing Che on Minikube with Keycloak as the OIDC provider
    • Configuring Che
      • Understanding the CheCluster Custom Resource
        • Using chectl to configure the CheCluster Custom Resource during installation
        • Using the CLI to configure the CheCluster Custom Resource
        • CheCluster Custom Resource fields reference
      • Configuring namespaces
        • Configuring namespace name
        • Provisioning namespaces in advance
      • Configuring server components
        • Mounting a Secret or a ConfigMap as a file or an environment variable into a Eclipse Che container
        • Advanced configuration options for Che server
      • Configuring workspaces globally
        • Limiting the number of workspaces that a user can keep
        • Enabling users to run multiple workspaces simultaneously
        • Git with self-signed certificates
        • Configuring workspaces nodeSelector
        • Open VSX registry URL
      • Caching images for faster workspace start
        • Defining the list of images
        • Defining the memory settings
        • Installing Image Puller on OpenShift using the web console
        • Installing Image Puller on OpenShift using CLI
      • Configuring observability
        • Che-Theia workspaces
          • The Woopra telemetry plugin
          • Creating a telemetry plugin
        • Configuring server logging
        • Collecting logs using chectl
        • Monitoring with Prometheus and Grafana
          • Installing Prometheus and Grafana
          • Monitoring the Dev Workspace Operator
          • Monitoring Che Server
      • Configuring networking
        • Configuring network policies
        • Configuring Che hostname
        • Importing untrusted TLS certificates to Che
        • Configuring Kubernetes Ingress
        • Configuring OpenShift Route
      • Configuring storage
        • Installing Che using storage classes
      • Managing identities and authorizations
        • OAuth for GitHub, GitLab, or Bitbucket
          • Configuring OAuth 2.0 for GitHub
          • Configuring OAuth 2.0 for GitLab
          • Configuring OAuth 1.0 for a Bitbucket Server
          • Configuring OAuth 2.0 for the Bitbucket Cloud
        • Configuring the administrative user
        • Removing user data
    • Managing IDE extensions
      • Extensions for Microsoft Visual Studio Code - Open Source
    • Using the Che server API
    • Upgrading Che
      • Upgrading the chectl management tool
      • Specifying the update approval strategy
      • Upgrading Che using the OpenShift web console
      • Upgrading Che using the CLI management tool
      • Upgrading Che in a restricted environment
      • Repairing the Dev Workspace Operator on OpenShift
    • Uninstalling Che
    • Extensions
      • OpenShift Connector
        • Features of OpenShift Connector
        • Installing OpenShift Connector in Eclipse Che
        • Authenticating with OpenShift Connector from Eclipse Che
        • Creating Components with OpenShift Connector in Eclipse Che
        • Connecting source code from GitHub to a OpenShift Component
    • Che glossary
Documentation next
  • Documentation
    • next
    • old (7.41)
    • stable
  • Documentation
  • User Guide
  • Troubleshooting Che
next old (7.41) stable
Edit this Page

Troubleshooting Che

This section provides troubleshooting procedures for the most frequent issues a user can come in conflict with.

Additional resources

  • Viewing Che workspaces logs

  • Investigating failures at a workspace start using the Verbose mode

  • Troubleshooting slow workspaces

  • Troubleshooting network problems

Site Map | Eclipse Foundation | Privacy Policy | Terms of Use | Eclipse Public License | Legal Resources