About Eclipse Che

Eclipse Che is a next generation Eclipse IDE. This repository is licensed under the Eclipse Public License 2.0. Visit Eclipse Che's Web site for feature information or the main Che assembly repository for a description of all participating repositories.

Eclipse Che Dashboard

Requirements

• Node.js v12 and later.
• yarn v1.20.0 or higher.

Note: Below you can find installation instructions

• Node.js
• yarn

Quick start

docker build . -f apache.Dockerfile -t quay.io/che-incubator/che-dashboard-next:next

Running

Install all dependencies:

yarn

and start dev-server:

The start command requires to specify a remote Eclipse Che server like:

yarn start --env.server=https://che-che.192.168.99.100.nip.io

The development server serves the project on http://localhost:3000.

note: To use CodeReady Workspaces(based on Che) Hosted by Red Hat instance at https://workspaces.openshift.com, use the fully qualified host name of the cluster. URL is looking like https://codeready-codeready-workspaces-operator.apps.sandbox.x8i5.p1.openshiftapps.com

yarn start --env.server=https://codeready-codeready-workspaces-operator.apps.sandbox.x8i5.p1.openshiftapps.com

To specify a different port, add --port=3333

For redirect/authentication issues, please validate settings of Valid Redirect URIs and Web Origins on keycloak for che-public client. Valid Redirect URIs requires http://localhost:3000/* and Web Origins requires http://localhost:3000 (using default port number)

For better debugging experience you need to have React and Redux Developer Tools installed in your browser.

Production

To launch the production mode, the command is

yarn serve:prod

it requires a compilation

yarn compile

To provide a custom remote server:

yarn serve:prod --env.server=https://codeready-codeready-workspaces-operator.apps.sandbox.x8i5.p1.openshiftapps.com

License tool

It uses dash-licenses to check all dependencies (including transitive) to be known to Eclipse IPZilla or ClearlyDefined. It generates .deps/dev.md and .deps/prod.md that contains such information.

Firstly, build the license-tool dockerfile:

yarn licenseCheck:prepare

and then run the license-tool:

yarn licenseCheck:run

Branding

Default branding data for the User Dashboard is located in branding.constant.ts#BRANDING_DEFAULT. It can be overridden without re-building the project in product.json file which should contain only values that should overwrite default ones.

Configurability

Field "configuration.cheCliTool" should contain the name of a CLI tool that is recommended to be used to work with Che Server from the terminal. It's the "chectl" by default.

Example:

{
  "configuration": {
    "cheCliTool": "chectl"
  }
}

Field "header.warning" allows you to display a message at the top of the dashboard. You can use HTML to configure the field but only the '<a>' tag and 'href', 'target' properties are accepted. It's undefined by default.

Example:

{
  "header": {
    "warning": "Server upgrades are happening at 1:00 PM. To learn more visit <a href='foo' target='_blank'>foo</a>"
  }
}

License

Che is open sourced under the Eclipse Public License 2.0.