Changeset View
Changeset View
Standalone View
Standalone View
src/docs/user/configuration/configuring_outbound_email.diviner
| @title Configuring Outbound Email | @title Configuring Outbound Email | ||||
| @group config | @group config | ||||
| Instructions for configuring Phabricator to send mail. | Instructions for configuring Phabricator to send mail. | ||||
| Overview | Overview | ||||
| ======== | ======== | ||||
| Phabricator can send outbound email through several different mail services, | Phabricator can send outbound email through several different mail services, | ||||
| including a local mailer or various third-party services. Options include: | including a local mailer or various third-party services. Options include: | ||||
| | Send Mail With | Setup | Cost | Inbound | Notes | | | Send Mail With | Setup | Cost | Inbound | Notes | | ||||
| |---------|-------|------|---------|-------| | |---------|-------|------|---------|-------| | ||||
| | Mailgun | Easy | Cheap | Yes | Recommended | | | Mailgun | Easy | Cheap | Yes | Recommended | | ||||
| | Postmark | Easy | Cheap | Yes | Recommended | | |||||
| | Amazon SES | Easy | Cheap | No | Recommended | | | Amazon SES | Easy | Cheap | No | Recommended | | ||||
| | SendGrid | Medium | Cheap | Yes | Discouraged | | | SendGrid | Medium | Cheap | Yes | Discouraged | | ||||
| | External SMTP | Medium | Varies | No | Gmail, etc. | | | External SMTP | Medium | Varies | No | Gmail, etc. | | ||||
| | Local SMTP | Hard | Free | No | sendmail, postfix, etc | | | Local SMTP | Hard | Free | No | sendmail, postfix, etc | | ||||
| | Custom | Hard | Free | No | Write a custom mailer for some other service. | | | Custom | Hard | Free | No | Write a custom mailer for some other service. | | ||||
| | Drop in a Hole | Easy | Free | No | Drops mail in a deep, dark hole. | | | Drop in a Hole | Easy | Free | No | Drops mail in a deep, dark hole. | | ||||
| See below for details on how to select and configure mail delivery for each | See below for details on how to select and configure mail delivery for each | ||||
| ▲ Show 20 Lines • Show All 119 Lines • ▼ Show 20 Lines | |||||
| <http://www.mailgun.com>. Mailgun is easy to configure and works well. | <http://www.mailgun.com>. Mailgun is easy to configure and works well. | ||||
| To use this mailer, set `type` to `mailgun`, then configure these `options`: | To use this mailer, set `type` to `mailgun`, then configure these `options`: | ||||
| - `api-key`: Required string. Your Mailgun API key. | - `api-key`: Required string. Your Mailgun API key. | ||||
| - `domain`: Required string. Your Mailgun domain. | - `domain`: Required string. Your Mailgun domain. | ||||
| Mailer: Postmark | |||||
| ================ | |||||
| Postmark is a third-party email delivery serivice. You can learn more at | |||||
| <https://www.postmarkapp.com/>. | |||||
| To use this mailer, set `type` to `postmark`, then configure these `options`: | |||||
| - `access-token`: Required string. Your Postmark access token. | |||||
| Mailer: Amazon SES | Mailer: Amazon SES | ||||
| ================== | ================== | ||||
| Amazon SES is Amazon's cloud email service. You can learn more at | Amazon SES is Amazon's cloud email service. You can learn more at | ||||
| <http://aws.amazon.com/ses/>. | <http://aws.amazon.com/ses/>. | ||||
| To use this mailer, set `type` to `ses`, then configure these `options`: | To use this mailer, set `type` to `ses`, then configure these `options`: | ||||
| ▲ Show 20 Lines • Show All 143 Lines • Show Last 20 Lines | |||||