Changeset View
Changeset View
Standalone View
Standalone View
src/docs/user/configuration/configuring_inbound_email.diviner
| @title Configuring Inbound Email | @title Configuring Inbound Email | ||||
| @group config | @group config | ||||
| This document contains instructions for configuring inbound email, so users | This document contains instructions for configuring inbound email, so users | ||||
| may interact with some Phabricator applications via email. | may interact with some Phabricator applications via email. | ||||
| = Preamble = | = Preamble = | ||||
| This can be extremely difficult to configure correctly. This is doubly true if | This can be extremely difficult to configure correctly. This is doubly true if | ||||
| you use a local MTA. | you use a local MTA. | ||||
| There are a few approaches available: | There are a few approaches available: | ||||
| | Receive Mail With | Setup | Cost | Notes | | | Receive Mail With | Setup | Cost | Notes | | ||||
| |--------|-------|------|-------| | |--------|-------|------|-------| | ||||
| | Mailgun | Easy | Cheap | Recommended | | | Mailgun | Easy | Cheap | Recommended | | ||||
| | Postmark | Easy | Cheap | Recommended | | |||||
| | SendGrid | Easy | Cheap | | | | SendGrid | Easy | Cheap | | | ||||
| | Local MTA | Extremely Difficult | Free | Strongly discouraged! | | | Local MTA | Extremely Difficult | Free | Strongly discouraged! | | ||||
| The remainder of this document walks through configuring Phabricator to | The remainder of this document walks through configuring Phabricator to | ||||
| receive mail, and then configuring your chosen transport to deliver mail | receive mail, and then configuring your chosen transport to deliver mail | ||||
| to Phabricator. | to Phabricator. | ||||
| = Configuring Phabricator = | = Configuring Phabricator = | ||||
| ▲ Show 20 Lines • Show All 100 Lines • ▼ Show 20 Lines | |||||
| like this: | like this: | ||||
| - Configure a mail domain according to Mailgun's instructions. | - Configure a mail domain according to Mailgun's instructions. | ||||
| - Add a Mailgun route with a `catch_all()` rule which takes the action | - Add a Mailgun route with a `catch_all()` rule which takes the action | ||||
| `forward("https://phabricator.example.com/mail/mailgun/")`. Replace the | `forward("https://phabricator.example.com/mail/mailgun/")`. Replace the | ||||
| example domain with your actual domain. | example domain with your actual domain. | ||||
| - Set the `mailgun.api-key` config key to your Mailgun API key. | - Set the `mailgun.api-key` config key to your Mailgun API key. | ||||
| Postmark Setup | |||||
| ============== | |||||
| To process inbound mail from Postmark, configure this URI as your inbound | |||||
| webhook URI in the Postmark control panel: | |||||
| ``` | |||||
| https://<phabricator.yourdomain.com>/mail/postmark/ | |||||
| ``` | |||||
| = SendGrid Setup = | = SendGrid Setup = | ||||
| To use SendGrid, you need a SendGrid account with access to the "Parse API" for | To use SendGrid, you need a SendGrid account with access to the "Parse API" for | ||||
| inbound email. Provided you have such an account, configure it like this: | inbound email. Provided you have such an account, configure it like this: | ||||
| - Configure an MX record according to SendGrid's instructions, i.e. add | - Configure an MX record according to SendGrid's instructions, i.e. add | ||||
| `phabricator.example.com MX 10 mx.sendgrid.net.` or similar. | `phabricator.example.com MX 10 mx.sendgrid.net.` or similar. | ||||
| - Go to the "Parse Incoming Emails" page on SendGrid | - Go to the "Parse Incoming Emails" page on SendGrid | ||||
| ▲ Show 20 Lines • Show All 78 Lines • Show Last 20 Lines | |||||