From cf12356572b64ecc8d9c3a81ad7d71174a7479b3 Mon Sep 17 00:00:00 2001
From: phile314-isska <phile314-isska@users.noreply.github.com>
Date: Tue, 29 Nov 2016 15:27:53 +0100
Subject: [PATCH] Document ssmtp for email notifications. (#426)

---
 doc/manual/projects.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/manual/projects.xml b/doc/manual/projects.xml
index a8ee2b13..ca1598e5 100644
--- a/doc/manual/projects.xml
+++ b/doc/manual/projects.xml
@@ -471,6 +471,26 @@ build_exotic =
 
   <xi:include href="declarative-projects.xml" />
 
+  <section>
+    <title>Email Notifications</title>
+    <para>
+      Hydra can send email notifications when the status of a build changes. This provides
+      immediate feedback to maintainers or committers when a change causes build failures.
+    </para>
+
+    <para>
+      The simplest approach to enable Email Notifications is to use the ssmtp package, which
+      simply hands off the emails to another SMTP server. For details on how to configure ssmtp,
+      see the documentation for the <varname>networking.defaultMailServer</varname> option.
+      To use ssmtp for the Hydra email notifications, add it to the path option of the Hydra services
+      in your <filename>/etc/nixos/configuration.nix</filename> file:
+<programlisting>
+systemd.services.hydra-queue-runner.path = [ pkgs.ssmtp ];
+systemd.services.hydra-server.path = [ pkgs.ssmtp ];
+</programlisting>
+    </para>
+  </section>
+
 </chapter>
 
 <!--