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


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.


Che supports different flavors of OpenShift:

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

On any computer with MiniShift running (v1.23.0 or greater):

minishift addons enable che && minishift addons apply che

Installation and configuration docs: