diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 000000000..eaae23a2c
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,13 @@
+version: 2
+
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "mambaforge-latest"
+  jobs:
+    pre_build:
+      # add cloned repository to python importable paths
+      - 'echo "$(pwd)" >> $(python -c "import sysconfig;print(sysconfig.get_paths()[\"purelib\"])")/workdir.pth'
+
+conda:
+  environment: docs/environment.yml
diff --git a/readthedocs.yml b/readthedocs.yml
deleted file mode 100644
index 004a03aec..000000000
--- a/readthedocs.yml
+++ /dev/null
@@ -1,2 +0,0 @@
-conda:
-  file: docs/environment.yml