Configuration FileΒΆ

In addition to using the admin panel of your project to configure your project, you can use a configuration file in the root of your project. The configuration file can be named:

  • readthedocs.yml

  • readthedocs.yaml

  • .readthedocs.yml

  • .readthedocs.yaml

The main advantages of using a configuration file over the web interface are:

  • Settings are per version rather than per project.

  • Settings live in your VCS.

  • They enable reproducible build environments over time.

  • Some settings are only available using a configuration file

Tip

Using a configuration file is the recommended way of using Read the Docs.