diff --git a/.readthedocs.yml b/.readthedocs.yml
index 8aa32d5..a3a73df 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -1,18 +1,21 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
 version: 2
 
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
 build:
-  os: ubuntu-22.04
+  os: "ubuntu-22.04"
   tools:
     python: "3.11"
 
 python:
-    install:
-        - method: pip
-          path: .
-          extra_requirements:
-            - docs
-
-# Let the build fail if there are any warnings
-sphinx:
-    builder: html
-    fail_on_warning: true
+  install:
+    - requirements: docs/requirements.txt
+    - method: pip
+      path: .
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000..668b55a
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,18 @@
+aiida-core
+sphinx
+sphinxcontrib-contentui
+sphinxcontrib-details-directive
+furo
+markupsafe<2.1
+pandas
+numpy
+aiida-submission-controller
+pydantic
+ase
+sphinx-rtd-theme
+cclib
+aiida-dataframe
+multiprocess
+subproptools
+group_decomposition
+voluptuous