diff --git a/.readthedocs.yml b/.readthedocs.yml
index c9c61617c..2625521e5 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -1,3 +1,15 @@
+# https://blog.readthedocs.com/migrate-configuration-v2/
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+sphinx:
+  configuration: docs/conf.py
+
 python:
-  version: 3
-requirements_file: docs/requirements.txt
+  install:
+  - requirements: docs/requirements.txt