Eclipse Che

https://www.eclipse.org/che/. Next-generation Eclipse IDE. Open source workspace server and cloud IDE.

Workspaces With Runtimes

Workspaces are composed of projects and runtimes. Create portable and moavable workspaces that run anywhere, anytime in the cloud or on your desktop ... Read More

Collaborative Workspace Server

Host Eclipse Che as a workspace server. Share tools, runtime and programming services across workspaces and teams. Control workspaces with REST APIs ... Read More

Docker-Powered Environments

Workspace runtimes are Docker-powered. Use our all-in-one stacks, pull from any registry, or author your own. Snapshot and embed runtimes into ... Read More

Cloud IDE

A no-installation browser IDE and IOE accessible from any local or remote device. Thin, fast, and beautiful - it's the IDE our own engineers wanted ... Read More

Getting Started

Che can be installed on any OS that supports Java 1.8 - desktop, server or cloud, and Maven 3.3.1. It has been tested on Ubuntu, Linux, MacOS and Windows.

Follow the step by step guide to install Che from our binaries.

License

Che is open sourced under the Eclipse Public License 1.0.

Dependencies

• Docker 1.8+
• Maven 3.3.1+
• Oracle Java 1.8 -- compilation with openjdk is not yet supported

Clone

git clone https://github.com/eclipse/che.git

If master is unstable, checkout the latest tagged version.

Build and Run

cd che/assembly
mvn clean install

# A new assembly is placed in:
cd che/assembly/assembly-main/target/eclipse-che-<version>/eclipse-che-<version>

# Executable files are:
bin/che.sh
bin/che.bat

Che will be available at localhost:8080.

Build Submodules

Building /assembly pulls already-built libraries for /core, /plugins, and /dashboard from our Nexus repository.

To build core:

# Install maven-patch-plugin as an additional dependency.
cd che/core

# Windows: maven-patch-plugin does not work, so skip tests when building:
# See: https://maven.apache.org/plugins/maven-patch-plugin/faq.html#Why_doesnt_this_work_on_Windows
mvn -DskipTests=true -Dfindbugs.skip=true  -Dskip-validate-sources clean install

To build plugins:

cd che/plugins
mvn clean install

To build dashboard:

# You need NPM, Bower, and Gulp installed.
# See setup in /dashboard
cd che/dashboard
mvn clean install

Run Che as a Server

If you want to run Che as a server where non-localhost clients connect, there are additional flags that you may need to configure. Please see the usage documentation.

Repositories

These repositories are for the core project hosted at http://github.com/eclipse.

/che
/che/assembly                                             # Generates binary assemblies of Che
/che/assembly/assembly-main                               # Final packaging phase
/che/assembly/assembly-ide-war                            # Creates the IDE.war from plug-ins & core
/che/assembly/assembly-machine-war                        # Creates the agent WAR from plug-ins & core
/che/assembly/assembly-machine-server                     # Creates the agent server that goes into ws
/che/core                                                 # Libraries shared among server, agents, and plugins
/che/dashboard                                            # AngularJS app for managing Che
/che/plugins                                              # IDE & agent plug-ins
/che/wsmaster                                             # Libraries used by the Che server
/che/wsagent                                              # Libraries used by agents installed into workspaces

/che-lib                                                  # Forked dependencies that require mods
/che-lib/swagger
/che-lib/terminal
/che-lib/websocket
/che-lib/pty
/che-lib/che-tomcat8-slf4j-logback

# /che and /che-lib depend upon /che-dependencies
/che-dependencies                                          # Maven dependencies used by che
/che-dev                                                   # Code style and license header

# /che-dependencies and /che-dev depend upon /che-parent
/che-parent                                                # Maven plugins and profiles

Other Repositories

These are external repositories that provide additional tools for Eclipse Che.

http://github.com/codenvy/che-installer                    # Creates the Windows and JAR installer packages
http://github.com/codenvy/che-tutorials                    # SDK examples and tutorials (needs updating)
http://github.com/che-samples                              # GitHub organization with sample repos used in Che
http://git.eclipse.org/c/www.eclipse.org/che.git           # The content for eclipse.org/che Web site
http://github.com/codenvy/cli                              # Experimental CLI for managing Che workspaces on the CLI

Engage

• Contribute: We accept pull requests. Please see [how to contribute] (https://github.com/codenvy/che/blob/master/CONTRIBUTING.md).
• Customize: Runtimes, stacks, commands, assemblies, extensions, plug-ins.
• Support: You can report bugs using GitHub issues.
• Roadmap: We maintain the roadmap on the wiki.
• Weekly Meetings: Join us on a hangout.
• Developers: Plug-in developers can get API help at che-dev@eclipse.org.
• Website: eclipse.org/che.