Docker image definitions used by Read the Docs
Clone or download
Latest commit 116621e Dec 13, 2018

README.rst

Read the Docs - Docker Images

These are the Docker image definitions used by the Read the Docs build environments to encapsulate the build process.

You can find these images on Docker Hub, on the readthedocs/build repository:

readthedocs/build:1.0
Deprecated Ubuntu 14.04 based image
readthedocs/build:1.0-dotnet
Deprecated Ubuntu 14.04 based image, plus .NET
readthedocs/build:2.0
stable Ubuntu 16.04 based image. This is the stable image previously used
readthedocs/build:3.0
latest Ubuntu 16.04 supporting Python 2.7, 3.3, 3.4, 3.5, and 3.6. This is the latest default image supported by Read the Docs
readthedocs/build:4.0rc1
testing Ubuntu 18.04 release candidate supporting Python 2.7, 3.5, 3.6, 3.7. For internal development testing only, not available for public usage yet.

Usage

To use the pre-built images, you can pull from Docker Hub:

docker pull readthedocs/build:latest

You can also compile these images locally:

docker build -t readthedocs/build:testing .

See CONTRIBUTING for more information on building and testing.