diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
index ce6313e..92e5fad 100644
--- a/.github/workflows/pages.yml
+++ b/.github/workflows/pages.yml
@@ -16,9 +16,6 @@ env:
 jobs:
   build:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        shell: bash -l {0}
     steps:
       - uses: actions/checkout@v4
       - uses: prefix-dev/setup-pixi@v0.8.1
diff --git a/docs/.readthedocs.yaml b/docs/.readthedocs.yaml
new file mode 100644
index 0000000..8ce7a39
--- /dev/null
+++ b/docs/.readthedocs.yaml
@@ -0,0 +1,12 @@
+version: 2
+
+build:
+  os: ubuntu-lts-latest
+  tools:
+    # `mambaforge-latest` will now start failing: we just need a working `mamba`
+    python: mambaforge-23.11
+  commands:
+    - mamba install -c conda-forge -c nodefaults pixi==0.35.0
+    - pixi r build
+    - pixi r docs-sphinx
+    - pixi r -v docs-rtd