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

Eclipse Che is available in two different modes:

  • Single-user: perfectly suited for personal desktop environment.
  • Multi-user: best for organization and developer teams.

Considering the multi-user mode as an advanced setup of Eclipe Che, the quick starts are covering only the single-user mode. If you are interested by the multi-user, please read the following pages:

If you want to learn more about the differences between single-user and multi-user, please read this page

Docker

On any computer with Docker 17+ installed:

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

Note that /local/path can be any path on your local machine where you want to store Che data and projects.

MacOS users will also need to setup IP alias.

Installation and configuration docs:

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

OpenShift

Che supports different flavors of OpenShift:

If you want to try Che on OpenShift, we recommand to you to do it with MiniShift and use the MiniShift add-on for Che.

On any computer with MiniShift running:

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

Installation and configuration docs: