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:ubuntu-20.04-YYYY.MM.DD

Ubuntu 20.04 supporting multiple versions of Python, PyPy, conda, mamba, nodejs, rust and go. Available for public usage as build.os: ubuntu-20.04

Note that these images only contains the basic dependencies:

• asdf CLI manager to install the languages versions
• LaTeX packages to build PDFs
• Chinese fonts

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

docker pull readthedocs/build:ubuntu-20.04-YYYY.MM.DD

You can also compile these images locally:

docker build -t readthedocs/build:ubuntu-20.04-YYYY.MM.DD .

See CONTRIBUTING for more information on building and testing.