Discource-C
/
discourse
mirror of https://github.com/discourse/discourse.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
discourse/docs/INSTALL-email.md

48 lines
2.5 KiB
Markdown
Raw Normal View History

don't need giant header
2016-04-29 06:42:45 -04:00
### Recommended Email Providers for Discourse
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
Update INSTALL-email.md
2016-03-12 02:08:22 -05:00
We strongly recommend using a dedicated email service. Email server setup and maintenance is _very_ difficult even for experienced system administrators, and getting any part of the complex required email setup wrong means your email won't be delivered, or worse, delivered erratically.
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
The following are template configurations for email service providers who offer generous free plans that work for most communities.
Update INSTALL-email.md
2016-04-29 06:17:48 -04:00
**Please note that in any email provider, you _must_ verify and use the subdomain, e.g. `discourse.example.com`. If you verify the domain only, e.g. `example.com`, mail will not be configured correctly.**
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
Update INSTALL-email.md
2016-04-29 06:17:48 -04:00
Enter these values when prompted by `./discourse-setup` per the [install guide](https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md#edit-discourse-configuration):
move mailgun to top--elastic email seems to confuse people
2017-10-11 18:53:12 -04:00
#### [Mailgun][gun] — 10k emails/month (with credit card)
SMTP server address? smtp.mailgun.org
SMTP user name? [SMTP credentials for your domain under domains tab]
SMTP password? [SMTP credentials for your domain under domains tab]
update sendgrid info they no longer offer the 12k/month email free plan just a 30 day trial
2017-02-06 17:37:04 -05:00
#### [SendGrid][sg] — 40k emails on a 30 day trial
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
Update INSTALL-email.md
2016-04-29 06:17:48 -04:00
SMTP server address? smtp.sendgrid.net
SMTP user name? apikey
SMTP password? [SendGrid API Key]
Change SendGrid info to use api key While it does work I don't think using your SendGrid username and password is good practice so we probably shouldn't promote it. API Keys should be used instead.
2016-03-21 09:47:54 -04:00
We recommend creating an [API Key][sg2] instead of using your SendGrid username and password.
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
Update INSTALL-email.md
2016-04-30 04:32:45 -04:00
#### [Mailjet][jet] — 6k emails/month
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
Go to [My Account page](https://www.mailjet.com/account) and click on the ["SMTP and SEND API Settings"](https://www.mailjet.com/account/setup) link.
add elastic back in, at the bottom per sort order
2019-02-12 21:40:46 -05:00
#### [Elastic Email][ee] — 3k emails/month (100 max/day)
SMTP server address? smtp.elasticemail.com
SMTP user name? [Your registered email address]
SMTP password? [Elastic Email API Key]
SMTP port? 2525
NOTE: Elastic Email policy insists on an additional UNSUBSCRIBE link at the bottom of each sent email. If this is a problem for your needs, consider using other providers. [See discussion here](https://meta.discourse.org/t/remove-or-merge-elastic-email-unsubscribe/70236).
Added Elastic Email
2017-05-13 00:10:21 -04:00
[ee]: https://elasticemail.com
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
[jet]: https://www.mailjet.com/pricing
HTTPSify links (#7046)
2019-02-22 10:29:27 -05:00
[gun]: https://www.mailgun.com/
Add an Email Services Template page - Link Admin Quick Start and basic install to services page - Provide templates for various email service providers
2016-03-11 12:37:17 -05:00
[sg]: https://sendgrid.com/
Change SendGrid info to use api key While it does work I don't think using your SendGrid username and password is good practice so we probably shouldn't promote it. API Keys should be used instead.
2016-03-21 09:47:54 -04:00
[sg2]: https://sendgrid.com/docs/Classroom/Send/How_Emails_Are_Sent/api_keys.html
add elastic back in, at the bottom per sort order
2019-02-12 21:40:46 -05:00
Add brief section on bounce handling to email doc (#6900)
2019-01-18 04:02:05 -05:00
### Bounce Handling
When using a third party email service, you will need to enable VERP, or activate their **webhooks** in order to handle bouncing emails. [Full details here.](https://meta.discourse.org/t/handling-bouncing-e-mails/45343)