diff --git a/.readthedocs.yml b/.readthedocs.yml
index 03c98983..57a8b182 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -1,23 +1,22 @@
 version: 2
 
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
     python: "3.12"
   jobs:
-    post_install:
+    pre_create_environment:
       - asdf plugin add uv
       - asdf install uv latest
       - asdf global uv latest
-      - uv sync --group docs
-    build:
-      html:
-        - uv run -- sphinx-build -M html docs $READTHEDOCS_OUTPUT
-      pdf:
-        - uv run -- sphinx-build -M latexpdf docs $READTHEDOCS_OUTPUT
+    create_environment:
+      - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    install:
+      - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --group docs --link-mode=copy
 
 sphinx:
   configuration: docs/conf.py
+  fail_on_warning: false
 
 formats:
   - pdf