116 lines
3.3 KiB
Markdown
116 lines
3.3 KiB
Markdown
## Overview
|
|
|
|
This documentation describes how to enable the email-related capabilities of Remark.
|
|
|
|
- email authentication for users:
|
|
|
|
enabling this will let the user log in using their emails:
|
|
|
|
|
|
|
|
- email notifications for any users except anonymous:
|
|
|
|
GitHub or Google or Twitter or any other kind of user gets the ability to get email notifications about new replies to their comments:
|
|
|
|
|
|
|
|
## Setup email server connection
|
|
|
|
To enable any of email functionality you need to set up email (SMTP) server connection using these variables:
|
|
|
|
```
|
|
SMTP_HOST
|
|
SMTP_PORT
|
|
SMTP_TLS
|
|
SMTP_USERNAME
|
|
SMTP_PASSWORD
|
|
SMTP_TIMEOUT
|
|
```
|
|
|
|
### Mailgun
|
|
|
|
This is an example of a configuration using [Mailgun](https://www.mailgun.com/) email service:
|
|
|
|
```
|
|
- SMTP_HOST=smtp.eu.mailgun.org
|
|
- SMTP_PORT=465
|
|
- SMTP_TLS=true
|
|
- SMTP_USERNAME=postmaster@mg.example.com
|
|
- SMTP_PASSWORD=secretpassword
|
|
- AUTH_EMAIL_FROM=notify@example.com
|
|
```
|
|
|
|
### Gmail
|
|
|
|
Configuration example for Gmail:
|
|
|
|
```
|
|
- SMTP_HOST=smtp.gmail.com
|
|
- SMTP_PORT=465
|
|
- SMTP_TLS=true
|
|
- SMTP_USERNAME=example.user@gmail.com
|
|
- SMTP_PASSWORD=secretpassword
|
|
- AUTH_EMAIL_FROM=example.user@gmail.com
|
|
```
|
|
|
|
### Amazon SES
|
|
|
|
Configuration example for [Amazon SES](https://aws.amazon.com/ses/) (us-east-1 region):
|
|
```
|
|
- SMTP_HOST=email-smtp.us-east-1.amazonaws.com
|
|
- SMTP_PORT=465
|
|
- SMTP_TLS=true
|
|
- SMTP_USERNAME=access_key_id
|
|
- SMTP_PASSWORD=secret_access_key
|
|
- AUTH_EMAIL_FROM=notify@example.com
|
|
|
|
```
|
|
|
|
A domain or an email that will be used in `AUTH_EMAIL_FROM` or `NOTIFY_EMAIL_FROM` must first be [verified](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-domain-procedure.html).
|
|
|
|
[SMTP Credentials](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-credentials.html) must first be obtained from [Amazon SES Console](https://console.aws.amazon.com/ses/home?region=us-east-1#smtp-settings:):
|
|
|
|
## Setup email authentication
|
|
|
|
Here is the list of variables which affect email authentication:
|
|
|
|
```
|
|
AUTH_EMAIL_ENABLE
|
|
AUTH_EMAIL_FROM
|
|
AUTH_EMAIL_SUBJ
|
|
AUTH_EMAIL_CONTENT_TYPE
|
|
AUTH_EMAIL_TEMPLATE
|
|
```
|
|
|
|
After `SMTP_` variables are set, you can allow email authentication by setting these two variables:
|
|
|
|
```
|
|
- AUTH_EMAIL_ENABLE=true
|
|
- AUTH_EMAIL_FROM=notify@example.com
|
|
```
|
|
|
|
|
|
Usually, you don't need to change/set anything else. In case if you want to use a different email template set `AUTH_EMAIL_TEMPLATE`, for instance
|
|
`- AUTH_EMAIL_TEMPLATE="Confirmation email, token: {{.Token}}"`. See [verified-authentication](https://github.com/go-pkgz/auth#verified-authentication) for more details.
|
|
|
|
## Setup email notifications
|
|
|
|
Here is the list of variables which affect email notifications:
|
|
|
|
```
|
|
NOTIFY_TYPE
|
|
NOTIFY_EMAIL_FROM
|
|
NOTIFY_EMAIL_VERIFICATION_SUBJ
|
|
# for administrator notifications for new comments on their site
|
|
ADMIN_SHARED_EMAIL
|
|
NOTIFY_EMAIL_ADMIN
|
|
```
|
|
|
|
After `SMTP_` variables are set, you can allow email notifications by setting these two variables:
|
|
|
|
```
|
|
- NOTIFY_TYPE=email
|
|
# - NOTIFY_TYPE=email,telegram # this is in case you want to have both email and telegram notifications enabled
|
|
- NOTIFY_EMAIL_FROM=notify@example.com
|
|
```
|