From ce0e3cb520f57c5d73a58b3752e0ec4073506ff6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Robert=20Sch=C3=A4fer?= <git@roschaefer.de>
Date: Mon, 24 Jun 2019 13:15:05 +0200
Subject: [PATCH] Write documentation for mailserver deployment

---
 SUMMARY.md                                     |  1 +
 .../human-connection/mailserver/README.md      | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)
 create mode 100644 deployment/human-connection/mailserver/README.md

diff --git a/SUMMARY.md b/SUMMARY.md
index 701eac2d0..c281e2fae 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -27,6 +27,7 @@
     * [Kubernetes Dashboard](deployment/digital-ocean/dashboard/README.md)
     * [HTTPS](deployment/digital-ocean/https/README.md)
   * [Human Connection](deployment/human-connection/README.md)
+    * [Mailserver](deployment/human-connection/mailserver/README.md)
   * [Volumes](deployment/volumes/README.md)
     * [Neo4J Offline-Backups](deployment/volumes/neo4j-offline-backup/README.md)
     * [Volume Snapshots](deployment/volumes/volume-snapshots/README.md)
diff --git a/deployment/human-connection/mailserver/README.md b/deployment/human-connection/mailserver/README.md
new file mode 100644
index 000000000..9a224a3b9
--- /dev/null
+++ b/deployment/human-connection/mailserver/README.md
@@ -0,0 +1,18 @@
+# Development Mail Server
+
+You can deploy a fake smtp server which captures all send mails and displays
+them in a web interface. The [sample configuration](../templates/configmap.template.yml)
+is assuming such a dummy server in the `SMTP_HOST` configuration and points to
+a cluster-internal SMTP server.
+
+To deploy the SMTP server just uncomment the relevant code in the
+[ingress server configuration](../../https/templates/ingress.template.yaml) and
+run the following:
+
+```bash
+# in folder deployment/human-connection
+kubectl apply -f mailserver/
+```
+
+You might need to refresh the TLS secret to enable HTTPS on the publicly
+available web interface.