diff --git a/postgresql/README.md b/postgresql/README.md
new file mode 100644
index 00000000..855ee8a9
--- /dev/null
+++ b/postgresql/README.md
@@ -0,0 +1,10 @@
+---
+gitea: none
+include_toc: true
+---
+
+# PostgreSQL database
+
+
+
+
diff --git a/synapse/README.md b/synapse/README.md
index b2ac1c13..e2781d0d 100644
--- a/synapse/README.md
+++ b/synapse/README.md
@@ -42,8 +42,15 @@ There are two different ways to configure Synapse, documented here:
 
 We'll use Synapse, using the workers architecture to make it scalable, flexible and reusable.
 
+# Database
 
-## Logging
+The default installation leaves you with an sqlite3 database. Nice for experimenting, but
+unsuitable for a production environment.
+
+[Here's how you setup PostgreSQL](../postgres).
+
+
+# Logging
 
 Logging is configured in `log.yaml`. Some logging should go to systemd, the
 more specific logging to Synapse's own logfile(s).