Docker on WSL (Windows 10 Home / Docker Toolbox)
(Virtualbox instead Hyper-V)

Docker on WSL communicates with Docker on Windows from Docker Toolbox.


Install VirtualBox and Docker Toolbox on Windows.


Docker on Windows uses VM for Linux based docker containers.
Create new docker machine (VM):
````
> docker-machine.exe create default
````

Start the default docker machine:
````
> docker-machine.exe start default
````


Find out (Docker daemon) IP of default docker-machine and use that IP for Docker client:
````
> docker-machine.exe ip
````

In case of error:
````
open C:\Users\<user>\.docker\machine\machines\default\config.json: The system cannot find the file specified.
````
Remove folder in 
C:\Users\<user>\.docker\machine\machines
manually.

Then try again:
````
> docker-machine.exe rm default
[y]
> docker-machine.exe create default
````



After setting up environment variables for Docker client:
````
> docker info
````


In case of error:
````
could not read CA certificate "/home/build/.docker/ca.pem": open /home/build/.docker/ca.pem: no such file or directory
````
Remove folder in 
C:\Users\<user>\.docker\machine\machines
manually.

Then try again:
````
> docker-machine.exe rm default
[y]
> docker-machine.exe create default
````
Extra fix if necessary:
````
> docker-machine.exe regenerate-certs default
[y]
````



Note:
In Windows, docker client has to run as admin, otherwise this error will occur:
````
open //./pipe/docker_engine: The system cannot find the file specified. In the default daemon configuration on Windows
````

If already running as admin, try this fix

````
> docker-machine env
````

Copy + paste/run the printed for loop (without commenting out REM) for configuring.

Important: The `@FOR` loop without the `REM`!
````
C:\Users\<user>>docker-machine env
SET DOCKER_TLS_VERIFY=1
SET DOCKER_HOST=tcp://192.168.99.100:2376
SET DOCKER_CERT_PATH=C:\Users\<user>\.docker\machine\machines\default
SET DOCKER_MACHINE_NAME=default
SET COMPOSE_CONVERT_WINDOWS_PATHS=true
REM Run this command to configure your shell:
REM     @FOR /f "tokens=*" %i IN ('docker-machine env') DO @%i
````
From that output, copy + paste and execute the whole thing in cmd.
Then copy the `@FOR` line without `REM     ` and also paste and execute in cmd:
````
> @FOR /f "tokens=*" %i IN ('docker-machine env') DO @%i
````

````
> docker-machine ls
> docker-machine start default
````


Network/other issues with virtual machine
Open VirtualBox GUI and stop + remove the default machine manually, then try again.
Extra tip: Update VirtualBox + VirtualBox Extensions to latest version.



Test:
````
> docker run hello-world
````

This should download + run the hello-world docker container.


On WSL, [install Docker CE](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/)(for Ubuntu (=WSL basically)).

`docker info` will now show an error (can't connect to daemon).

Edit:
docker-env wrapper script that translates Windows style ENV to *nix (WSL) style `export`:
https://gist.github.com/mmarchini/bc9df7b82127fea13612edf8bffdf96f

````
$ mkdir -p ~/.bin/
$ cd ~/.bin/
$ wget -O docker-env https://gist.github.com/mmarchini/bc9df7b82127fea13612edf8bffdf96f/raw/33f14362f98fa168c17ad6b04a053c2066e071f0/docker-env
$ chmod +x ./docker-env
````

Test the script:
````
$ ./docker-env
````



.bashrc on WSL:
```.bashrc
# Docker (Docker Toolbox on Windows)
source <(~/.bin/docker-env)
alias docker-machine="docker-machine.exe"
#alias docker="docker.exe" # Native docker client is used instead, less issues with environment variables
docker-machine.exe start default && # autostart docker-machine
# docker-compose path compatibility
export COMPOSE_CONVERT_WINDOWS_PATHS=1
````

Tip: Load the new bash script in existing terminal using `source ~/.bashrc` to avoid restarting the terminal.



Share certs from Docker Toolbox on Windows with Docker client on WSL:
````
$ mkdir -p ~/.docker
$ ln -s /mnt/c/Users/<user>/.docker/machine/certs/ca.pem ~/.docker/ca.pem
$ ln -s /mnt/c/Users/<user>/.docker/machine/certs/ca-key.pem ~/.docker/ca-key.pem
$ ln -s /mnt/c/Users/<user>/.docker/machine/certs/cert.pem ~/.docker/cert.pem
$ ln -s /mnt/c/Users/<user>/.docker/machine/certs/key.pem ~/.docker/key.pem
````

Note: _All_ of these files have to be made available/symlinked!


[Install docker-compose](https://docs.docker.com/compose/install/#install-compose)(for Linux) natively on WSL.

\* There is also docker-compose shipped with Docker Toolbox (alias docker-compose to docker-compose.exe)
  – but it may be older and not the same style as the natively installed Docker client.


Paths in docker-compose in Bash on Windows/WSL:
````
ERROR: for <container>  Cannot start service php: oci runtime error: container_linux.go:262: starting container process caused "chdir to cwd (\"<target container path>\") set in config.json failed: no such file or directory"
````
See https://github.com/Microsoft/BashOnWindows/issues/1854


Proposed solutions:

.env file with this content:
````
COMPOSE_CONVERT_WINDOWS_PATHS=1
````

export as environment variable:
````
export COMPOSE_CONVERT_WINDOWS_PATHS=1
````

or in .bashrc:
````
COMPOSE_CONVERT_WINDOWS_PATHS=1
````

But this doesn't resolve the issue for me...
Edit: Apparently it works now, I installed the latest Windows 10 updates (and got a newer WSL version).