Files
discourse/docs/INSTALL-email.md
T

41 lines
2.0 KiB
Markdown
Raw Normal View History

2016-04-29 03:42:45 -07:00
### Recommended Email Providers for Discourse
2016-03-11 11:37:17 -06:00
2016-03-11 23:08:22 -08: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.
2016-03-11 11:37:17 -06:00
The following are template configurations for email service providers who offer generous free plans that work for most communities.
2016-04-29 03:17:48 -07: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.**
2016-03-11 11:37:17 -06:00
2016-04-29 03:17:48 -07: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):
#### [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]
2017-05-13 09:40:21 +05:30
#### [Elastic Email][ee] — 150k emails/month
SMTP server address? smtp.elasticemail.com
SMTP user name? [Your registered email address]
SMTP password? [Elastic Email API Key]
SMTP port? 2525
2017-02-06 15:37:04 -07:00
#### [SendGrid][sg] — 40k emails on a 30 day trial
2016-03-11 11:37:17 -06:00
2016-04-29 03:17:48 -07:00
SMTP server address? smtp.sendgrid.net
SMTP user name? apikey
SMTP password? [SendGrid API Key]
2016-03-21 07:47:54 -06:00
We recommend creating an [API Key][sg2] instead of using your SendGrid username and password.
2016-03-11 11:37:17 -06:00
2016-04-30 01:32:45 -07:00
#### [Mailjet][jet] — 6k emails/month
2016-03-11 11:37:17 -06: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.
2017-05-13 09:40:21 +05:30
[ee]: https://elasticemail.com
2016-03-11 11:37:17 -06:00
[jet]: https://www.mailjet.com/pricing
[gun]: http://www.mailgun.com/
[sg]: https://sendgrid.com/
2016-03-21 07:47:54 -06:00
[sg2]: https://sendgrid.com/docs/Classroom/Send/How_Emails_Are_Sent/api_keys.html