diff --git a/.github/workflows/build-book.yml b/.github/workflows/build-book.yml
index 7694cc6..7b4d7ae 100644
--- a/.github/workflows/build-book.yml
+++ b/.github/workflows/build-book.yml
@@ -17,14 +17,13 @@ jobs:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies with pip
       run: |
-        python -m pip install --upgrade pip
+        python -m pip install --upgrade 'pip<25.3'
         python -m pip install wheel
         python -m pip install git+https://github.com/atmtools/climt@rrtmg-only --no-binary climt
         TARGET=HASWELL python -m pip install .[docs]
         python -m pip list
     - name: build book
       run: |
-        conda info
         jupyter-book build -W -n --keep-going howto
     - name: Archive build artifacts
       uses: actions/upload-artifact@v4
diff --git a/.github/workflows/build-test.yml b/.github/workflows/build-test.yml
index 12690c1..965b901 100644
--- a/.github/workflows/build-test.yml
+++ b/.github/workflows/build-test.yml
@@ -36,13 +36,13 @@ jobs:
           TARGET: HASWELL
         run: |
           brew install gcc@12
-          python -m pip install --upgrade pip wheel
+          python -m pip install --upgrade 'pip<25.3' wheel
           python -m pip install git+https://github.com/atmtools/climt@rrtmg-only --no-binary climt
 
       - name: Install CliMT (Linux)
         if: matrix.name == 'ubuntu'
         run: |
-          python -m pip install --upgrade pip wheel
+          python -m pip install --upgrade 'pip<25.3' wheel
           python -m pip install git+https://github.com/atmtools/climt@rrtmg-only --no-binary climt
 
       - name: Install
diff --git a/README.md b/README.md
index ed60509..349883f 100644
--- a/README.md
+++ b/README.md
@@ -20,18 +20,18 @@ But of course, any other Python distribution is also working.
 ## Install stable release
 You can install the latest stable version of ``konrad`` using ``pip``:
 ```bash
-python -m pip install konrad
+python3 -m pip install konrad
 ```
 
 Konrad depends on the [CliMT](https://github.com/CliMT/climt) package.
 CliMT handles a variety of underlying FORTRAN code and provides precompiled
 binary wheels for some Python versions and operating systems.
 
-However (for Python >3.7) the FORTRAN libraries need to be compiled locally.
+However, on some architectures the FORTRAN libraries need to be compiled locally.
 In this case, you need to specify a C compiler, a FORTRAN compiler, and the
 target architecture using the corresponding environment variables:
 ```bash
-CC=gcc FC=gfortran TARGET=HASWELL python -m pip install konrad
+CC=gcc FC=gfortran TARGET=HASWELL python3 -m pip install konrad
 ```
 
 ### macOS
diff --git a/environment.yaml b/environment.yaml
index 7d7dac8..f34ab38 100644
--- a/environment.yaml
+++ b/environment.yaml
@@ -4,7 +4,7 @@ channels:
     - rttools
 dependencies:
     - python==3.10
-    - jupyter-book
+    - jupyter-book<2
     - matplotlib>=2.0.0
     - netcdf4>=1.2.7
     - numpy>1.22.0
diff --git a/setup.cfg b/setup.cfg
index 097d896..b301e8b 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -32,7 +32,7 @@ install_requires =
 arts =
     pyarts>=2.5.8
 docs =
-    jupyter-book
+    jupyter-book<2
     sphinx
     sphinx_rtd_theme
 tests =