diff --git a/matrix/synapse/README.md b/matrix/synapse/README.md
index 29743f0..36d0adf 100644
--- a/matrix/synapse/README.md
+++ b/matrix/synapse/README.md
@@ -214,3 +214,32 @@ ip_range_blacklist:
 You want to add addresses of malicious or otherwise unwanted machines to this
 list too. See [Synapse's documentation](https://element-hq.github.io/synapse/latest/usage/configuration/config_documentation.html?highlight=ip_range_blacklist#ip_range_blacklist)
 for more information.
+
+
+# E-mail {#Email}
+
+Synapse should probably be able to send out e-mails; notifications for those
+who want that, and password reset for those who need one.
+
+You configure this under the section `email` (yes, really). 
+
+First of all, you need an SMTP-server that is configured to send e-mail for
+your domain. Configuring that is out of scope, we'll assume we can use the
+server `smtp.example.com`.
+
+Configure this in `conf.d/email.yaml`:
+
+```
+email:
+  smtp_host: smtp.example.com
+  smtp_port: 465
+  smtp_user: matrix@example.com
+  smtp_pass: SuperSecretPassword
+  force_tls: true
+  notif_from: "Your Matrix server <matrix@example.com>"
+```
+
+This configures an SMTP-connection with SSL (port 465, `force_tls`). See Matrix'
+[email documentation](https://element-hq.github.io/synapse/latest/usage/configuration/config_documentation.html?highlight=require_transport_security#email)
+for more information.
+