diff --git a/README.rst b/README.rst
index 2e903e2464b7ad07aa086d41b1fc81ed2200966b..a1a76b0a20c9ee258b92b07dd65a78070d45c92e 100644
--- a/README.rst
+++ b/README.rst
@@ -25,16 +25,11 @@ Installation using python virtual environment - recommended
 ===========================================================
 
 `pycalibration` uses the same version of Python as Karabo, which in June 2021
-updated to use Python 3.8. Currently the default python installation on Maxwell
-is still Python 3.6.8, so Python 3.8 needs to be loaded from a different
+updated to use Python 3.11. Currently the default python installation on Maxwell
+is still Python 3.9, so Python 3.11 needs to be loaded from a different
 location.
 
-One option is to use the Maxwell Spack installation, running `module load
-maxwell` will activate the test Spack instance from DESY, then you can use
-`module load python-3.8.6-gcc-10.2.0-622qtxd` to Python 3.8. Note that this Spack
-instance is currently a trial phase and may not be stable.
-
-Another option is to use `pyenv`, we provide a pyenv installation at
+Therefore `pyenv` is used, we provide a pyenv installation at
 `/gpfs/exfel/sw/calsoft/.pyenv` which we use to manage different versions of
 python. This can be activated with ``source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate``
 
@@ -42,7 +37,7 @@ A quick setup would be:
 
 1. ``source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate``
 2. ``git clone ssh://git@git.xfel.eu:10022/detectors/pycalibration.git && cd pycalibration`` - clone the offline calibration package from EuXFEL GitLab
-3. ``pyenv shell 3.8.18`` - load required version of python
+3. ``pyenv shell 3.11.9`` - load required version of python
 4. ``python3 -m venv .venv`` - create the virtual environment
 5. ``source .venv/bin/activate`` - activate the virtual environment
 6. ``python3 -m pip install --upgrade pip`` - upgrade version of pip
@@ -55,7 +50,7 @@ Copy/paste script:
   source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate
   git clone ssh://git@git.xfel.eu:10022/detectors/pycalibration.git
   cd pycalibration
-  pyenv shell 3.8.18
+  pyenv shell 3.11.9
   python3 -m venv .venv
   source .venv/bin/activate
   python3 -m pip install --upgrade pip
@@ -73,7 +68,7 @@ installation method instead.
 
 1. ``source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate``
 2. ``git clone ssh://git@git.xfel.eu:10022/detectors/pycalibration.git && cd pycalibration`` - clone the offline calibration package from EuXFEL GitLab
-3. ``pyenv shell 3.8.18`` - load required version of python
+3. ``pyenv shell 3.11.9`` - load required version of python
 4. ``pip install .`` - install the pycalibration package (add ``-e`` flag for editable development installation)
 5. ``export PATH=$HOME/.local/bin:$PATH`` - make sure that the home directory is in the PATH environment variable
 
@@ -83,7 +78,7 @@ Copy/paste script:
 
   source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate
   git clone ssh://git@git.xfel.eu:10022/detectors/pycalibration.git
-  pyenv shell 3.8.18
+  pyenv shell 3.11.9
   cd pycalibration
   pip install --user .  # `-e` flag for editable install, e.g. `pip install -e .`
   export PATH=$HOME/.local/bin:$PATH
diff --git a/docs/development/installation.md b/docs/development/installation.md
index 158b2fca26f4d24bb83157145c8a675b0b8c74f7..7e6064d4bdbed22390a93b6c0e1b6aad1b66fc8c 100644
--- a/docs/development/installation.md
+++ b/docs/development/installation.md
@@ -11,27 +11,21 @@ to do this.
 
 ## Installation using python virtual environment - recommended
 
-`pycalibration` uses Python 3.8. Currently, the default
-python installation on Maxwell is still Python 3.6.8, so Python 3.8
-needs to be loaded from a different location.
+`pycalibration` uses the same version of Python as Karabo, which in June 2021
+updated to use Python 3.11. Currently the default python installation on Maxwell
+is still Python 3.9, so Python 3.11 needs to be loaded from a different
+location.
 
-One option is to use the Maxwell Spack installation, running `module
-load maxwell` will activate the test Spack instance from
-DESY, then you can use `module load
-python-3.8.6-gcc-10.2.0-622qtxd` to Python 3.8. Note that
-this Spack instance is currently a trial phase and may not be stable.
-
-Another option is to use `pyenv`, we provide a pyenv
-installation at `/gpfs/exfel/sw/calsoft/.pyenv` which we use
-to manage different versions of python. This can be activated with
-`source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate`
+Therefore `pyenv` is used, we provide a pyenv installation at
+`/gpfs/exfel/sw/calsoft/.pyenv` which we use to manage different versions of
+python. This can be activated with ``source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate``
 
 A quick setup would be:
 
 1.  `source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate`
 2.  `git clone ssh://git@git.xfel.eu:10022/detectors/pycalibration.git && cd pycalibration` -
     clone the offline calibration package from EuXFEL GitLab
-3.  `pyenv shell 3.8.18` - load required version of python
+3.  `pyenv shell 3.11.9` - load required version of python
 4.  `python3 -m venv .venv` - create the virtual environment
 5.  `source .venv/bin/activate` - activate the virtual environment
 6.  `python3 -m pip install --upgrade pip` - upgrade version of pip
@@ -44,7 +38,7 @@ Copy/paste script:
 source /gpfs/exfel/sw/calsoft/.pyenv/bin/activate
 git clone ssh://git@git.xfel.eu:10022/detectors/pycalibration.git
 cd pycalibration
-pyenv shell 3.8.18
+pyenv shell 3.11.9
 python3 -m venv .venv
 source .venv/bin/activate
 python3 -m pip install --upgrade pip