codenvy/che-launcher repository overview

The launcher verifies that the appropriate Docker client is configured, configures Che through environment variables (following good 12-factor app practices), and handles configuration nuances between different forms of Docker such as boot2docker, xhyve, and Docker on linux before launching Eclipse Che in a second container. This allows us to offer a Docker run syntax that is identical for every operating system.

⁠Start Che:

docker run -t -v /var/run/docker.sock:/var/run/docker.sock codenvy/che-launcher start

⁠Stop Che:

docker run -t -v /var/run/docker.sock:/var/run/docker.sock codenvy/che-launcher stop

⁠Upgrade Che:

docker run -t -v /var/run/docker.sock:/var/run/docker.sock codenvy/che-launcher update

⁠You can configure Che by setting environment variables:

docker run -v /var/run/docker.sock:/var/run/docker.sock
-e =
codenvy/che-launcher start

CHE_HOSTNAME - External hostname of Che server CHE_PORT - External port of Che server CHE_VERSION - Che server version (only support >4.5.0) CHE_RESTART_POLICY - Che server restart policy if exited CHE_USER - User ID of the Che server in its container CHE_CONF_FOLDER - Folder where custom che.properties provided CHE_LOG_LEVEL - Log level output of Che server, either ‘info’ or ‘debug’ CHE_DATA_FOLDER - Folder where user workspaces and preferences saved CHE_HOST_IP - IP address Che server will bind to CHE_LOCAL_BINARY - Path to replace embedded Che binary with one on your host

Dockerfile: https://github.com/eclipse/che/tree/master/dockerfiles/che-launcher⁠ - the Dockerfile also contains comments inside it that explain how it's used.

Eclipse Che site: https://eclipse.org/che/⁠ Eclipse Che docs: https://eclipse-che.readme.io/docs/⁠ Eclipse Che issues & help: https://github.com/eclipse/che/issues⁠