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


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