discourse/docs/INSTALL-email.md

### Recommended Email Providers for Discourse

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.

The following are template configurations for email service providers who offer generous free plans that work for most communities.

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

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

#### [SparkPost][sp] &mdash; 100k emails/month

    SMTP server address? smtp.sparkpostmail.com
    SMTP user name?      SMTP_Injection
    SMTP password?       [Any API key with Send via SMTP permission]
    
#### [Elastic Email][ee] &mdash; 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

#### [SendGrid][sg] &mdash; 40k emails on a 30 day trial

    SMTP server address? smtp.sendgrid.net
    SMTP user name?      apikey
    SMTP password?       [SendGrid API Key]

We recommend creating an [API Key][sg2] instead of using your SendGrid username and password.

#### [Mailgun][gun] &mdash; 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]

#### [Mailjet][jet] &mdash; 6k emails/month

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.

   [sp]: https://www.sparkpost.com/
   [ee]: https://elasticemail.com
  [jet]: https://www.mailjet.com/pricing
  [gun]: http://www.mailgun.com/
   [sg]: https://sendgrid.com/
  [sg2]: https://sendgrid.com/docs/Classroom/Send/How_Emails_Are_Sent/api_keys.html
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):
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			`#### [SparkPost][sp] — 100k emails/month`
Add information about updating sending domain 2016-03-15 11:30:06 -04:00
Update INSTALL-email.md 2016-04-29 06:17:48 -04:00			`SMTP server address? smtp.sparkpostmail.com`
			`SMTP user name? SMTP_Injection`
			`SMTP password? [Any API key with Send via SMTP permission]`
Added Elastic Email 2017-05-13 00:10:21 -04:00
			`#### [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`
Add information about updating sending domain 2016-03-15 11:30:06 -04:00
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
add cc mention to mailgun 2017-03-06 15:38:02 -05:00			`#### [Mailgun][gun] — 10k emails/month (with credit card)`
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.mailgun.org`
			`SMTP user name? [SMTP credentials for your domain under domains tab]`
			`SMTP password? [SMTP credentials for your domain under domains tab]`
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.`

			`[sp]: https://www.sparkpost.com/`
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`
			`[gun]: http://www.mailgun.com/`
			`[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`