Deploying Che on supported OpenShift flavors and versions

Multi-user Eclipse Che can be deployed to OpenShift Container Platform 3.6 and later, OpenShift Dedicated, and OpenShift Online Pro.

The deployment script creates three DeploymentConfigs for Che, Postgres, and Keycloak. PVCs, services, and routes (Che and Keycloak only) are also created by the deployment script.

Deployment diagram

ocp multi user

Using Minishift to Deploy Che

Due to the size of a multi-user Eclipse Che installation, Minishift is not recommended as the base for this configuration. If you have to use Minishift, start it with at least 4GB of memory by including the --memory=4096 parameter, and update Minishift to the latest version.

$ curl -fsSL https://raw.githubusercontent.com/eclipse/che/master/deploy/openshift/deploy_che.sh -o deploy_che.sh
$ ./deploy_che.sh --multiuser

The script will download deployment templates, check your current oc session and context. Run ./deploy_che.sh --help to get a list of all deployment options.

Using OpenShift Container Platform to Deploy Che

HTTP Setup

$ curl -fsSL https://raw.githubusercontent.com/eclipse/che/master/deploy/openshift/deploy_che.sh -o deploy_che.sh
$ ./deploy_che.sh --multiuser

HTTPS Setup

IMPORTANT! Find instructions on adding self-signed certificates at the OpenShift Configuration page.

$ curl -fsSL https://raw.githubusercontent.com/eclipse/che/master/deploy/openshift/deploy_che.sh -o deploy_che.sh
$ ./deploy_che.sh --multiuser -s

Using OpenShift Dedicated to Deploy Che

The instructions to deploy Che to OpenShift Dedicated are identical to those for OpenShift Container Platform.

Using OpenShift Online Pro to deploy Che

The instructions to deploy Che to OpenShift Online PRO are identical to those for OpenShift Container Platform.

What is next?

Now that you have a running Che multi-user instance, create a user, set up GitHub oAuth, and log in.

Additional Resources

Kubernetes Admin Guide