Skip to content
Snippets Groups Projects
README.md 8.63 KiB

CircleCI license Project Status: Active – The project has reached a stable, usable state and is being actively developed. DOI

Visit rocker-project.org for more about available Rocker images, configuration, and use.

Version-stable Rocker images

rocker

For documentation for R >= 4.0.0, for images r-ver, rstudio, tidyverse, verse, geospatial, shiny, and binder, please see the rocker-versioned2 repository`.

image description size metrics build status
r-ver Version-stable base R & src build tools
rstudio Adds rstudio
tidyverse Adds tidyverse & devtools
verse Adds tex & publishing-related packages

rocker/geospatial, rocker/binder and rocker/shiny are also build on this stack, following the same versioning rules as described here.

This repository provides alternate stack to r-base, with an emphasis on reproducibility. Compared to those images, this stack:

  • builds on debian stable (debian:jessie for versions < 3.4.0, debian:stretch after, etc) release instead of debian:testing, so no more apt-get breaking when debian:testing repos are updated and you had to muck with -t unstable to get apt-get to work.
  • Further, this stack installs a fixed version of R itself from source, rather than whatever is already packaged for Debian (the r-base stack gets the latest R version as a binary from debian:unstable),
  • and it installs all R packages from a fixed snapshot of CRAN at a given date (MRAN repos).
  • provides images that are generally smaller than the r-base series

Users should include the version tag, e.g. rocker/verse:3.3.1 when reproduciblity is paramount, and use the default latest tag, e.g. rocker/verse for the most up-to-date R packages. All images still receive any Debian security patch updates. Note that any debian packages on these images (C libraries, compilers, etc) will likely be older/earlier versions than those found on the r-base image series.

NOTES

  • do not use apt-get install r-cran-* to install R packages on this stack. The requested R version and all R packages are installed from source in the version-stable stack. Installing R packages from apt (e.g. the r-cran-* packages) will install the version of R and versions of the packages that were built for the stable debian release (e.g. debian:stretch), giving you a second version of R and different packages. Please install R packages from source using the install.packages() R function (or the install2.r script), and use apt only to install necessary system libraries (e.g. libxml2). If you would prefer to install only the latest verions of packages from pre-built binaries using apt-get, consider using the r-base stack instead.

Version Tags

Using the R version tag will naturally lock the R version, and also lock the install date of any R packages on the image. For example, rocker/tidyverse:3.3.1 Docker image will always rebuild with R 3.3.1 and R packages installed from the 2016-10-31 MRAN snapshot, corresponding to the last day that version of R was the most recent release. Meanwhile rocker/tidyverse:latest will always have both the latest R version and latest versions of the R packages, built nightly.

See VERSIONS.md for details

Images

The image rocker/r-ver is the functional equivalent of r-base, though slightly pared down. Currently r-ver has tags for all minor R versions back to 3.1.0 (as far back as MRAN snapshots of CRAN are avialable); see all tags. Users can attempt to build other versions from the r-ver Dockerfile by specifying --build-arg R_VERSION=<VERSION>, though this is unlikely to work with very old R versions. Likewise, all non-current images are automatically pinned to a MRAN snapshot of CRAN from the last day that version was current. Users can set a custom snapshot date for the r-ver images by using --build-arg BUILD_DATE=<DATE> when building that Dockerfile.

The rocker/rstudio image builds with the latest version of RStudio by default. This can be customized by specifying the desired version in --build-arg RSTUDIO_VERSION=<VERSION> if building locally from its Dockerfile.

RStudio and Runtime Options

See the RStudio README for documentation on setting passwords, sharing volumes, adding RStudio Shiny Server(TM), and other configuration.