Install on Docker

Installing Docker

To install and run any of the gds_env flavours on your computer through Docker, all you need is Docker installed. Please note not every platform (most notably older or non-Pro versions of Windows) meet the requirements to run the Docker app. If your computer cannot run Docker easily, consider running gds_env through VirtualBox.

Here are a few useful links to install Docker:

Installing gds_env

Please check in the description of each flavour for the exact command. Generally speaking, if you have Docker installed and running on your computer, you can install gds_env by typing:

docker pull darribas/<gds-flavour>:10.0

where <gds-flavour> is one of gds_py, gds, gds_dev.

Running gds_env

Once installed, you can run a container by typing:

docker run --rm -ti -p 8888:8888 -v ${PWD}:/home/jovyan/work darribas/<gds-flavour>:10.0

A couple of notes on the command above:

  • This opens the 8888 port of the container so you can access JupyterLab from your browser. To access the Lab instance, you will have to point your browser to localhost:8888 and insert the token printed on the terminal
  • The command also mounts the current folder from where you run it (${PWD}) to the container. This means that you can see the files in that folder from JupyterLab by opening the work folder in its file browser. You can replace ${PWD} with the path to any folder on your local machine. For example, to mount the Desktop folder on a Mac, you can replace ${PWD} by /Users/<username>/Desktop.