Eclipse Che is a developer workspace server and cloud IDE. You install, run, and manage Eclipse Che with with different container orchestration engines such as Docker or OpenShift.

Eclipse Che is available in two modes:

  • Single-user: This is suited for personal desktop environments.

  • Multi-user: This is an advanced setup for Che and is for organizations and developer teams.

See Single and Multi-User Che to learn more. The quick starts are for single-user mode.

Running single-user Che on Docker

Prerequisites
  • Latest Docker version installed (Docker 17+).

  • On macOS, create an IP alias. In a terminal, run:

    # ifconfig lo0 alias $IP

    Where $IP is found either in Preferences > Advanced > Docker subnet, or run

    $ docker run --rm --net host eclipse/che-ip:nightly
Procedure

To run Che in single-user mode, run the command below. Note that /local/path in the command below needs to be changed and can be any path on your local machine where you want to store Che data and projects.

$ docker run -ti -v /var/run/docker.sock:/var/run/docker.sock -v /local/path:/data eclipse/che start

Once Che has started, it can be accessed at localhost:8080.

Next steps

Create and start your first workspace, import a project, and build and run your project.

Running single-user Che on OpenShift

Prerequisities

To run Che in single-user mode on Minishift, use:

$ git clone https://github.com/minishift/minishift-addons
$ minishift addons install <path_to_minishift-addons-clone>/add-ons/che
$ minishift addons enable che
$ minishift addons apply \
    --addon-env CHE_DOCKER_IMAGE=eclipse/che-server:nightly \
    --addon-env OPENSHIFT_TOKEN=$(oc whoami -t) \
    che
Next steps

Create and start your first workspace, import a project, and build and run your project.

See the following resources for more information on the Openshift variants supported by Che: