diff --git a/README.md b/README.md
index 3ba9f792..4cdffb28 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ We're building it with workers, so it will scale.
 
 ## Overview
 
-* Scalable: [workers](https://element-hq.github.io/synapse/latest/workers.html)
+* [Synapse](https://element-hq.github.io/synapse/latest/)
 * Webclient
 * Element Call
 * Management with [Synapse-Admin](https://github.com/Awesome-Technologies/synapse-admin)
@@ -28,7 +28,29 @@ tracking](https://element-hq.github.io/synapse/latest/consent_tracking.html)
 
 We'll use Synapse, using the workers architecture to make it scalable, flexible and reusable.
 
-Installation and configuration are documented under `synapse`, "monolithic"
+Mind you: this an installation on Debian Linux (at least for now).
+
+Start by installing the latest Synapse server, see the [upstream
+documentation](https://element-hq.github.io/synapse/latest/setup/installation.html).
+
+```
+apt install -y lsb-release wget apt-transport-https build-essential python3-dev libffi-dev \
+               python3-pip python3-setuptools sqlite3 \
+               libssl-dev virtualenv libjpeg-dev libxslt1-dev libicu-dev
+
+wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
+
+echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" |
+    tee /etc/apt/sources.list.d/matrix-org.list
+
+apt update
+apt install matrix-synapse-py3
+```
+
+
+
+
+Configuration is documented under `synapse`, "monolithic"
 for the standard installation, and "workers" for the advanced configuration.