Visit rocker-project.org for more about available Rocker images, configuration, and use.
Version-stable Rocker images
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 ofdebian:testing
, so no more apt-get breaking whendebian: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 fromapt
(e.g. ther-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 theinstall.packages()
R function (or theinstall2.r
script), and useapt
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 usingapt-get
, consider using ther-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.