diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 6ff1c4c8b8..5bd7c51f22 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -13,6 +13,13 @@ build:
   apt_packages:
     - curl
     - jq
+  jobs:
+    post_create_environment:
+      - pip install uv
+    post_install:
+      # VIRTUAL_ENV needs to be set manually for now.
+      # See https://github.com/readthedocs/readthedocs.org/pull/11152/
+      - VIRTUAL_ENV=$READTHEDOCS_VIRTUALENV_PATH uv pip install '.[docs]'
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
@@ -20,11 +27,3 @@ sphinx:
 
 # If using Sphinx, optionally build your docs in additional formats such as PDF and ePub
 formats: all
-
-# python -m pip install '.[docs]'
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs