remark42/docs/email.md at 509b4b66bd3b80aeea618a77b4deb3015622e96c

Files

T

Yonatan RybinskiandGitHub 1ba5e7a67e Added instructions for SES email configuration (#622 )

@cigan1  (Yonatan Rybinski)

* Added instructions for SES
* Fixed domain
* Changed the name to Amazon SES not AWS SES
* Removed the extra URL

2020-03-22 15:57:59 -05:00

3.2 KiB

Raw Blame History

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 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 (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.

SMTP Credentials must first be obtained from Amazon SES Console:

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 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

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

3.2 KiB Raw Blame History