diff --git a/README.md b/README.md
index 4cdffb28..e10281cc 100644
--- a/README.md
+++ b/README.md
@@ -47,7 +47,16 @@ apt update
 apt install matrix-synapse-py3
 ```
 
+This leaves a very basic configuration in `/etc/matrix-synapse/homeserver.yaml`
+and  two settings under `/etc/conf.d`. All other configuration items will also
+be configured with yaml-files in this directory.
 
+Configure the domain you with to use in `/etc/matrix-synapse/conf.d/server_name.yaml`.
+What you configure here will also be the global part of your Matrix handles
+(the part after the colon).
+
+You now have a standard Matrix server that uses sqlite. You really don't want
+to use this in production, so probably want to replace this with PostgreSQL.
 
 
 Configuration is documented under `synapse`, "monolithic"
diff --git a/synapse/README.md b/synapse/README.md
new file mode 100644
index 00000000..8a326a69
--- /dev/null
+++ b/synapse/README.md
@@ -0,0 +1,13 @@
+---
+gitea: none
+include_toc: true
+---
+
+# Installation and configuration of Synapse
+
+There are two different ways to install Synapse, documented here:
+
+* [Monolithic](monolithic)
+* [Workers](workers)
+
+