diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 000000000..1de8fcd91
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,22 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+  apt_packages:
+    - libegl1-mesa
+    - libgl1-mesa-dri
+    - libxcb-xfixes0-dev
+    - mesa-vulkan-drivers
+    - libglfw3
+
+sphinx:
+  configuration: docs/source/conf.py
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
diff --git a/requirements_rtd.txt b/requirements_rtd.txt
deleted file mode 100644
index 14d59e156..000000000
--- a/requirements_rtd.txt
+++ /dev/null
@@ -1,6 +0,0 @@
-numpy
-jupyterlab
-jupyter_rfb
-pygfx>=0.1.10
-pydata-sphinx-theme<0.10.0
-glfw
diff --git a/setup.py b/setup.py
index f671a59d6..47b9b4877 100644
--- a/setup.py
+++ b/setup.py
@@ -10,6 +10,14 @@
 ]
 
 
+extras_require = {
+    "docs": [
+        "sphinx",
+        "pydata-sphinx-theme<0.10.0",
+        "glfw"
+    ],
+}
+
 with open(Path(__file__).parent.joinpath("README.md")) as f:
     readme = f.read()
 
@@ -37,6 +45,7 @@
     author_email='',
     python_requires='>=3.8',
     install_requires=install_requires,
+    extras_require=extras_require,
     include_package_data=True,
     description='A fast plotting library built using the pygfx render engine'
 )