diff --git a/web/content/docs/userguide/basics/jupyter-notebooks.md b/web/content/docs/userguide/basics/jupyter-notebooks.md index fbbd7c3f7ae6adef96d5945fd0b2215ba1565fbc..e25fd5259e777059612652cc214a74db7aff2f4e 100644 --- a/web/content/docs/userguide/basics/jupyter-notebooks.md +++ b/web/content/docs/userguide/basics/jupyter-notebooks.md @@ -45,6 +45,24 @@ docker run --rm -p 8888:8888 -v $PWD:/home/jovyan/work --user `id -u $USER` \ This mounts your current directory into `~/work` inside the container. + +<div class="note"> + +#### <i class="fab fa-windows"></i> Windows notes + +The above command only works when you run Docker from within a WSL2 Linux shell! + +- Install [Docker Desktop on Windows](https://docs.docker.com/desktop/windows/install/), it automatically configures WSL2. +- Install a Linux distribution from the Microsoft App Store. We recommend [Ubuntu 20.04](https://www.microsoft.com/en-us/p/ubuntu-2004-lts/9n6svws3rx71). +- In the Docker Desktop application under *Settings / Resources / WSL integration* add your Linux distribution. +- Open a command prompt in your Linux distribution (At the start menu type the name of the distribution) and run the container. + - If your current working contains spaces write out `$PWD`, e.g.: + ``` + ... -v /c/Users/My\ Name/working/directory:/home/jovyan/work ... + ``` + +</div> + --- With [Singularity]({{< ref "container.md#with-singularity" >}}):