diff --git a/.readthedocs.yml b/.readthedocs.yml
index 3d7a86b2a..c74e12a24 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -4,8 +4,12 @@
 
 version: 2
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
 python:
-  version: 3.8
   install:
   - requirements: doc/requirements.txt
   system_packages: true
diff --git a/doc/requirements.txt b/doc/requirements.txt
index d5c71da91..2f08b8d9e 100644
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -2,9 +2,11 @@
 #
 # SPDX-License-Identifier: CC0-1.0
 
+setuptools
 sphinx
 sphinx_book_theme
 sphinxcontrib-bibtex
+myst-parser  # recommark is deprecated, https://stackoverflow.com/a/71660856/13573820
 
 pypsa
 vresutils>=0.3.1