diff --git a/.readthedocs.yml b/.readthedocs.yml
index 079d7bb50..0d1c8898d 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -5,6 +5,13 @@
 # Required
 version: 2
 
+# build environment
+#   see: https://docs.readthedocs.io/en/stable/config-file/v2.html#build
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.10"
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   builder: html
@@ -19,6 +26,5 @@ formats: all
 
 # Optionally set the version of Python and requirements required to build your docs
 python:
-  version: 3.8
   install:
     - requirements: docs/requirements.txt