This section describes procedures to get started with Hosted Che that are not covered by Using developer environments - workspaces.

About Hosted Che

Hosted Che is Eclipse Che hosted by Red Hat. A Che server is running on OpenShift Dedicated, and the user base is spread across multiple OpenShift Online clusters where workspaces are created.

Terms of service

Hosted Che has the following usage limits and terms of service:

  • Storage: 2 GB

  • RAM: 7 GB

  • Concurrent workspaces: 1

  • Number of workspaces: Unlimited

  • Number of projects per workspace: Unlimited

  • Usage time limit: None

  • Maximum account inactivity period: 30 days

    Hosted Che automatically deactivates accounts that have been inactive for more than 30 days. All existing workspaces in a deactivated account are lost. To start using Hosted Che again, a user must re-register.
  • Workspace idling time: 15 minutes

    A started workspace can be used for an unlimited period of time. When there are no interactions with the IDE, the workspace is stopped after 15 minutes.
  • Temporary Storage: Defaults to Active

    In the temporary storage mode, workspaces have no persistent storage attached. All content changes are lost when the workspace is stopped unless they are pushed to a source-code repository first. This is done to improve the performance of workspace starts and file-system operations in the IDE.

It is possible to disable the temporary storage mode while creating a workspace from the user dashboard. For more information about the temporary storage mode, including how to disable it after workspace creation, see Using developer environments - workspaces.

Registering to Hosted Che

This section describes how to register to Hosted Che.

  1. Navigate to Hosted Che.

  2. Log in with an existing OpenShift Online, Red Hat Developer Program, or Red Hat Customer Portal account, or register for a new Red Hat account.

  3. Click the Activate account button.

  4. Wait for an email with a link to connect to the Eclipse Che instance. It is sent after the environment is ready for use.

  5. Follow the Get Started link in the email.

The Hosted Che user dashboard is displayed.

Creating a worskpace from the user dashboard

This section describes how to create a workspace from the user dashboard in Hosted Che.

  1. Navigate to the Hosted Che user dashboard.

  2. Click the Create Workspace button.

  3. Define a Name for the workspace. A generated name is proposed. It can be modified.

  4. In the Stack section, select the workspace runtime environment that will be used to build and run projects from the list.

  5. In the RAM section, adapt the memory available for the workspace runtime environment within the limits defined in the terms of service.

  6. In the Storage Type section, choose to have persistent storage attached or not. For more details, see Using different type of storage

  7. In the Projects section, choose the projects to integrate in the workspace. For the specific GitHub case, see Importing projects from GitHub in Hosted Che.

Additional resources

Creating a workspace from a template in Hosted Che

This section describes how to create a workspace from a predefined template.

Various programming languages and frameworks are supported.

  1. Navigate to the templates registry.

  2. Choose the required type of a workspace.

  3. Click the Launch Workspace button.

The workspace is created and displayed in Hosted Che.

getting started devfile

Importing projects from GitHub in Hosted Che

This section describes how to import a GitHub project in Hosted Che.

The user can import a GitHub project during the creation of a new workspace, or later, in an existing workspace.

  1. Navigate to the Projects section of the New Workspace creation window.

    Alternatively if the workspace is already existing, navigate to the Projects section of the Configure Workspace window.

  2. Click the Add Project button.

  3. Navigate to the GitHub tab.

  4. Click the Connect your GitHub account button.

  5. In the pop-up window, review the settings and click the Authorize openshiftio button.

  6. Type the password as requested and click the Confirm password button.

  7. Select the required repositories and click the Add button.

Contributing to GitHub projects in Hosted Che

This section describes how to contribute to GitHub projects in Hosted Che.

  1. Generate an SSH key pair with the SSH Plug-in.

  2. Upload the public key to the GitHub account. For details, see the Adding a new SSH key to your GitHub account procedure.

Finding the cluster where the Hosted Che workspace is running

This section describes how to find the cluster where the Hosted Che workspace is running with a query to the OpenShift API on Hosted Che.

  • The curl and jq packages are installed

  • Make a note of the username or email credential that the user used to log into Hosted Che

  1. Find the cluster name using the username.

    $ curl -sgSL "[username]=<username>" | jq -r ".data[0].attributes.cluster"
  2. Find the cluster name using the email.

    $ curl -sgSL "[email]=<email>" | jq -r ".data[0].attributes.cluster"

    The output of the query is the OpenShift Online cluster URL

  3. Browse to the previously retrieved URL.

  4. Log in using the OpenShift Online credentials.

The OpenShift Console is displayed.

The <username>-che namespace where all the workspace related Pods are created are accessible in read-only mode:

finding the cluster where the hosted che workspace is running

Frequently Asked Questions (FAQs) and Troubleshooting


Q: Where can I see the up-to-date status of Eclipse Che hosted by Red Hat?

A: On a dedicated status page -


Cannot log into the Hosted Che - Authorization token is missed

To authenticate to, one needs to allow cookies from the In case these cookies are blocked (by a browser extension like Privacy Badger), authentication fails with the following error:

Authorization token is missing
Click here to reload page.

Also, note that telemetry is enabled in Hosted Che so Woopra / Segment tracking scripts must be explicitly allowed in case being blocked by a browser extension:

Otherwise, the workspace startup will fail.

Additional resources