jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add clarity to apostrophes meaning in SMTP docs (#17265)

Browse Source
This commit is contained in:
Franck Nijhof 2021-04-04 21:27:23 +02:00 committed by GitHub
parent 482422f675
commit f4f408b417
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 86 additions and 88 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
source/_integrations/smtp.markdown
View File

@ -12,17 +12,17 @@ ha_platforms:
- notify
---
The `smtp` platform allows you to deliver notifications from Home Assistant to an e-mail recipient.
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:
- name: NOTIFIER_NAME
- name: "NOTIFIER_NAME"
platform: smtp
sender: YOUR_SENDER
recipient: YOUR_RECIPIENT
sender: "YOUR_SENDER"
recipient: "YOUR_RECIPIENT"
```
{% configuration %}
@ -59,7 +59,7 @@ username:
required: false
type: string
password:
description: Password for the SMTP server that belongs to the given username. If the password contains a colon it need to be wrapped in apostrophes.
description: Password for the SMTP server that belongs to the given username. Make sure to wrap it in double quotes; e.g., `"MY_PASSWORD"`.
required: false
type: string
encryption:
@ -72,7 +72,7 @@ sender_name:
required: false
type: string
debug:
description: Enables Debug, e.g., True or False.
description: Enables Debug, e.g., `true` or `false`.
required: false
type: boolean
default: false
@ -83,19 +83,19 @@ A sample configuration entry for Google Mail.
```yaml
# Example configuration.yaml entry
notify:
- name: NOTIFIER_NAME
- name: "NOTIFIER_NAME"
platform: smtp
server: smtp.gmail.com
server: "smtp.gmail.com"
port: 587
timeout: 15
sender: john@gmail.com
sender: "john@gmail.com"
encryption: starttls
username: john@gmail.com
password: thePassword
username: "john@gmail.com"
password: "thePassword"
recipient:
- james@gmail.com
- bob@gmail.com
sender_name: My Home Assistant
- "james@gmail.com"
- "bob@gmail.com"
sender_name: "My Home Assistant"
```
Keep in mind that Google has some extra layers of protection which need special attention (Hint: 'Less secure apps'). If you have 2-step verification enabled on your Google account, you'll need to use [an application-specific password](https://support.google.com/mail/answer/185833?hl=en).
@ -190,8 +190,6 @@ This platform is fragile and not able to catch all exceptions in a smart way bec
A combination that will work properly is port 587 and STARTTLS. It's recommended 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.