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
- Deprecated Ubuntu 16.04 based image.
- readthedocs/build:4.0
stable
Ubuntu 18.04 supporting Python 2.7, 3.5, 3.6, 3.7. This is the stable image supported by Read the Docs.- readthedocs/build:5.0
latest
Ubuntu 18.04 supporting Python 2.7, 3.6, 3.7 and pypy3.5-7.0.0. This is the latest default image used for documentation builds and supported by Read the Docs.- readthedocs/build:6.0rc1
- Ubuntu 18.04 supporting Python 2.7, 3.5, 3.6, 3.7 and PyPy3.5-7.0.0. For internal development testing only, not available for public usage yet.
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.