diff --git a/.readthedocs.yml b/.readthedocs.yml
index 82aacf1f4..0bd612cb6 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -8,15 +8,24 @@ version: 2
 # Build documentation in the doc/ directory with Sphinx
 sphinx:
   configuration: doc/conf.py
+  fail_on_warning: True
 
 # python requirements
 python:
-  version: 3.8
   install:
     - method: pip
       path: .
       extra_requirements:
         - doc
+        - amici
+
+build:
+  os: "ubuntu-20.04"
+  apt_packages:
+    - libatlas-base-dev
+    - swig
+  tools:
+    python: "3.10"
 
 # what to build
 formats: