Skip to content

Latest commit

 

History

History
38 lines (25 loc) · 1.86 KB

docker-notes.md

File metadata and controls

38 lines (25 loc) · 1.86 KB
Raw

Docker

If you want to run the software in a container (which can make package installation easier), you can use docker, which allows you to run a virtual operating system inside your main operating system.

After you have installed docker, you should be able to run the software by executing the following commands in a terminal such as Windows PowerShell or the default terminal on Linx and MAC operating systems.

For an R installation:

docker run -d -p 8787:8787 -v $(pwd):/home/rstudio/data -e USERID=$UID -e PASSWORD=pickASafePassWord --name rstudio robinlovelace/geocompr

For a R/Python docker image (bigger, less well maintained):

docker run -d -p 8787:8787 -v $(pwd):/home/rstudio/data -e USERID=$UID -e PASSWORD=pickASafePassWord --name rstudio robinlovelace/tds

This will:

  • Pull the docker image from https://hub.docker.com/r/robinlovelace/tds/ or the geocompr repo if it's not already on your computer
  • Launch a locally hosted instance of RStudio Server which can be accessed at http://localhost:8787/
  • Mount your current working dirctory to the data folder in the home directly of the docker image

After navigating to http://localhost:8787/ in a browser you should see a login screen. Username and password are rstudio. See https://github.com/rocker-org/rocker/wiki/Using-the-RStudio-image for details.

Once in the container you can use all the R packages. To access the pre-installed Python packages you will need to enter the following commands:

conda activate
python

to go into the Python shell. Form more on running Python in RStudio see community.rstudio.com. A demonstration showing the tds docker image in action is illustrated below.