sellorm / r-docker

Docker images for R

RStudio R Docker Images

RStudio creates and distributes an opinionated set of R binaries for different Linux distributions. These Docker images are built to use those R binaries. The images are intentionally minimal, their primary purpose is to serve as the basis for other images requiring R.

For a quick way to get started with R or RStudio, refer to the Rocker project.

WARNING: These images are considered experimental, and may change. They should not be used for strictly reproducible environments (yet!).

Sample Usage

These images can be used to execute R:

docker run --rm -it rstudio/r-base:3.5-xenial

These images can also be used as the basis for other custom images. To get started, use an image as the base in a Dockerfile:

FROM rstudio/r-base:3.5-xenial

Releases and Tags

The images follow these tag patterns:

Pattern	Example	Description
rstudio/r-base:distro	rstudio/r-base:centos7	Base operating system + system libraries required by R.
rstudio/r-base:x.y.z-distro	rstudio/r-base:3.5.3-centos7	R version x.y.z on the specified OS
rstudio/r-base:x.y-distro	rstudio/r-base:3.5-centos7	Latest R version x.y.z on the specified OS, where the patch version z floats over time. For example, if R 3.5.4 is released, rstudio/r-base:3.5-centos7 would switch from containing R 3.5.3 to R 3.5.4.

The following distributions are supported:

Distribution	Full Name
xenial	Ubuntu 16.04
bionic	Ubuntu 18.04
centos6	CentOS 6
centos7	CentOS 7
opensuse42	openSUSE 42.3
opensuse15	openSUSE 15.0

All minor versions of R since 3.1 are supported, on the latest patch release.

New versions of R are added when they're available on the RStudio CDN, though there may be some delay between the release of R and the release of the Docker image.

New operating systems are added on a less frequent basis.

What is R?

R is a language and environment for statistical computing and graphics. For more information:

• R Home
• R for Data Science

Resources

• Using Docker with R
• Using Docker with RStudio Server Pro

Support

RStudio does not provide professional support for these images or the R language. The best place to ask questions and provide feedback is the RStudio Community.

License

View license information for R.

---

Developer Resources

The following section contains information for those wishing to build these images themselves.

In general, the structure consists of the following:

• base: Base images that start with a minimal OS and add the necessary system requirements required by R.
• x.y: Images for each major.minor version of R. These images start from the base images and add R, copied from the RStudio CDN.

Building Images

# Build and test all images
make

# Build and test images for a specific R version
make VERSIONS=3.4

# Build and test images for a specific distro
make VARIANTS=xenial

# Build a specific image
make build-3.4-xenial

# Test a specific image
make test-3.4-xenial

Updating Images

1. Update update.sh and Makefile with the new distro or R version
2. Generate new Dockerfiles:

   make update-all
   
   # Or, using Docker
   make update-all-docker

3. Build and test the new images locally
4. Submit a pull request

Rebuilding Images

Rebuild images when the R build has been updated but there are no Dockerfile or base image changes. This ignores the Docker cache and reinstalls R in the image.

# rebuild all images
make rebuild-all

# Rebuild a specific image.
make rebuild-3.4-xenial