From 88dec902bf2a3d7f8c8f00598fe5a5516ef63bfd Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Wed, 3 Jun 2015 23:12:51 +0200
Subject: [PATCH 1/4] add smtp entry

---
 source/components/index.markdown | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/source/components/index.markdown b/source/components/index.markdown
index d91c44291bc..c0bc2cae529 100644
--- a/source/components/index.markdown
+++ b/source/components/index.markdown
@@ -207,6 +207,12 @@ the manufacturers of these devices.
 <td>Allow sending messages using PushOver.</td>
 </tr>
 
+<tr>
+<td><img src='/images/supported_brands/smtp.png' class='brand' /></td>
+<td><a href='/components/notify.xmpp.html'>E-Mail</a></td>
+<td>Allow sending e-mail messages.</td>
+</tr>
+
 <tr>
 <td><img src='/images/supported_brands/xmpp.png' class='brand' /></td>
 <td><a href='/components/notify.xmpp.html'>Jabber (XMPP)</a></td>

From 0f42a37518d2dd3c44e96ef00f780368e605b1b9 Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Wed, 3 Jun 2015 23:13:08 +0200
Subject: [PATCH 2/4] add smtp logo

---
 source/images/supported_brands/smtp.png | Bin 0 -> 1338 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 source/images/supported_brands/smtp.png

diff --git a/source/images/supported_brands/smtp.png b/source/images/supported_brands/smtp.png
new file mode 100644
index 0000000000000000000000000000000000000000..25ac6a0b16ae6fad80c8b88045b11d1893114ffc
GIT binary patch
literal 1338
zcmV-A1;zS_P)<h;3K|Lk000e1NJLTq002M$002M;1^@s6s%dfF00006VoOIv0RI60
z0RN!9r;`8x010qNS#tmY3ljhU3ljkVnw%H_000McNliru-v$E|FgRW!+tmO703B&m
zSad^gZEa<4bN~PV002XBWnpw>WFU8GbZ8()Nlj2>E@cM*00f>%L_t(|+U=TeXjfGj
z$3NTBnp;h?)XLUM8>B_qf@)C~OTmm)l7A4D{_2apXzope1hF>~R75Y*AyiNiHeUp3
ze+Gh4V(5#sT39YqY^cNjsGD<JQ(xRC8b6+M?zwm8-rp7P7tWh=pL3q`Jm;S0Jbw=4
z$dMyQjvP5IRg|Q}=SJWm;69)hm<CJ$D&>1Ga2n_aegXCa-vYaVe=k<$P6b+leZcvc
z?G(@s%mYd<7QycTJ_LqFA-L9#08PM{tO|ZD&;|^97QC<>1fIy6@Q(vM2@77>-UF`6
zf)Rbqalt<T8-eG6dw?3C3MdmnrUJ8pRlrBUQHMEylyODDSYUI=0*?agff+I8F9qfZ
zkKqv8a9i5KmjPQWi#iFc0mgaaHv{<0!tXF}eVPi`U|Gx;z@&uuE)(TyeD?z7X$Zf<
zBK#{UI9IpJj%)niOj`I`fIfxsFt9SkKd>73!?2F}BpGirXuhQgMtG*U(ArT*1oI5S
zf8c1*=L4I7pMVp<pxhE$fu%8B-BpG)H6)>coeHCF2WR8~;CqKV{X1Z?j4{z@*sjoR
z^(}n8VL^)=3}%#=;1Dn|q5|e9bmxF6J{8br@WN~sf3Ykis*AfRq5=Rq720Qg34a;z
zm%?C$Wz5Z%`#P+hi=lwm4T|)F`<2Phgm`%$TZGsKJP1^X{b(?p<0uN4Z?Gv|(5g)S
zsfGR~$>L}NykiNf-XDbmY7KFS7ihb=+Cu-5Vetom%Pr%|f!|{);A(}o-!<Y2L#@)c
z&q6=j(7zEFu#D@M7$Xi&DSh5DN5>THR$J(QHSFFj2VQj^|A5oJ{(vi$zJDzA6Ak@c
z4!pWzZjyHA_xMu46-r;Ph2G>Do^jyS7gGUsO5bn36wq%lSSFZ$y$T0jm7|DL3bDtR
z0<_&8Z=wIw&_CUQ*R3&xzXo_p>F@BR0PQ}VW}*Mt(C-qV#fjq9E64N*@Qtrqpk1-B
zO&0nVg9Yz$@B<D-yakpU=$d^7LTeQUn?tfj!!bO;cO!a&&5~0nq}fl9vG#@rg~{I`
zyV-6L;&XyRX{EG><-EGY0@c8Cmi$6LLCwJ{#>vEm%$^SM9(zf*QZxuGNGcts)c|&e
zj9DI2kS#IBbOVnjnSgxKz<6%RxRsX3P-{KF4H1R^L|oxSQ6^SAj=_0EvPUkp!<vws
z;D4=85*~M^nTCGRu$Z?T71$`2zEd(xL%?z1OG#gijNV3Ohfd1%*a5sM$&V_EfHKUl
zJ(harHHF{_P3B&O)En;jLD`v00_!Z-&@&11UIM&bYz36cxiuN6HvE;vM;^a7_`m))
ztJq4YB*?nj3LJ~@Qz>p#Y|qzOI0_Tc%Vi^5r}zTnBhEdB;33p*%iIgIpoDTq&usws
zis04AW8x}T5foj<61*_G7kGi-iQNf@Irn76D3(ZMb~Z)7zXP}~Yq!Hp+$%hB+cAkT
zGL1%HmuJC`11~$~6*J{DZIH#s5&A4a9dWVm1V`cdO~Zx0i{PQe-I7nNAxNKB$i3bt
wxyOSN6zu|bU{Am2$dMyQjvP61<QNSu0F!uY`=2eN2mk;807*qoM6N<$f|3wqQ2+n{

literal 0
HcmV?d00001


From 34770da209daa4ad2b3b045b4afebc549b42eb7e Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Wed, 3 Jun 2015 23:14:24 +0200
Subject: [PATCH 3/4] add smtp page

---
 source/components/notify.smtp.markdown | 39 ++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 source/components/notify.smtp.markdown

diff --git a/source/components/notify.smtp.markdown b/source/components/notify.smtp.markdown
new file mode 100644
index 00000000000..8971666befb
--- /dev/null
+++ b/source/components/notify.smtp.markdown
@@ -0,0 +1,39 @@
+---
+layout: page
+title: "SMTP notification support"
+description: "Instructions how to add e-mail notifications to Home Assistant."
+date: 2015-06-03 18:00
+sidebar: false
+comments: false
+sharing: true
+footer: true
+---
+
+<img src='/images/supported_brands/smtp.png' class='brand pull-right' />
+The smtp platform allows you to deliver notifications from Home Assistant to an e-mail recipient.
+
+To enable notification by e-mail in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+notify:
+  platform: mail
+  server: MAIL_SERVER
+  port: YOUR_SMTP_PORT
+  sender: SENDER_EMAIL_ADDRESS
+  starttls: 1 or 0
+  username: YOUR_SMTP_USERNAME
+  password: YOUR_SMTP_PASSWORD
+  recipient: YOUR_RECIPIENT
+```
+
+This platform is fragile and not able to catch all exceptions in a smart way because of the large number of possible configuration combinations. 
+
+A combination that will work properly is port 587 and STARTTLS. It's recommanded to enable STARTTLS, if possible. 
+
+Keep in mind that if the password contains a colon, it needs to be wrapped in apostrophes in the `configuration.yaml` file.
+
+For Google Mail (smtp.gmail.com) an additional step in the setup process is needed. Google has some extra layers of protection
+which need special attention. By default, the usage by external applications, especially scripts, is limited. Visit the [Less secure apps](https://www.google.com/settings/security/lesssecureapps) page and enable it.
+
+To use notifications, please see the [getting started with automation page]({{site_root}}/components/automation.html).

From 094243a320cecab190d0cc7d074068d6d73e438b Mon Sep 17 00:00:00 2001
From: Fabian Affolter <fabian@affolter-engineering.ch>
Date: Wed, 3 Jun 2015 23:16:43 +0200
Subject: [PATCH 4/4] update link

---
 source/components/index.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/source/components/index.markdown b/source/components/index.markdown
index c0bc2cae529..01ceff680ad 100644
--- a/source/components/index.markdown
+++ b/source/components/index.markdown
@@ -209,7 +209,7 @@ the manufacturers of these devices.
 
 <tr>
 <td><img src='/images/supported_brands/smtp.png' class='brand' /></td>
-<td><a href='/components/notify.xmpp.html'>E-Mail</a></td>
+<td><a href='/components/notify.smtp.html'>E-Mail</a></td>
 <td>Allow sending e-mail messages.</td>
 </tr>