Over the last year or so there has been a reasonable amount of evolution of the best way to get Eclipse Che running on Windows. The latest set of instructions are reasonably straightforward though not a complete no-brainer. This post records my snapshot of the step-by-step install process for Eclipse Che 5.2.2 including Docker install, dead ends & false starts.
- The aim is to set up a local install of pre-built Che on Windows 10 Home Edition. Starting point, scan documentation at https://www.eclipse.org/che/docs/setup/getting-started/
- Install prerequisite Docker. Download & install ‘Docker for Windows’. Helpful error message redirects me to use Docker Toolbox.
- Download Docker Toolbox for Windows. Run installer. Requires 77.6M, and also wants to install Git. The reason it needs to install a full source control system is merely down to the fact that the Git install comes with a nicely packaged bash & terminal implementation. Nevertheless I already have git installed so no need to here.
- Install completes, use shortcut ‘Docker Quickstart Terminal’ doesn’t work as it can’t find bash.exe (The shortcut expects Git to be in a certain default location).
- Update shortcut to point at my installed version of Git’s bash.exe (after another false start trying to use Git’s bash directly, fiddling with running things as Admin, etc).
- Success & I can run docker run hello-world
- Now to the actual Eclipse Che part, try default command line
docker run -it eclipse/che start
Not so hasty there, a helpful error message tells me I’m missing a mandatory parameter.
- Add in missing parameter, try again
docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock \ eclipse/che start
Get another useful message about needing to mount a directory to save data:
- Create a temporary directory and rerun the command specifying a data directory. Get a warning about data folder needing to be in %userprofile% (now you tell me).
- Make a different directory and run command again
docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock \ -v /c/Users/tracy/tmp:/data eclipse/che start
- Launch up browser, point at http://192.168.99.100:8080, Eclipse Che is up and running.