From 84dcf9045ce2000c1ba0d9a3ef40372979930aa0 Mon Sep 17 00:00:00 2001 From: epriestley Date: Wed, 5 Nov 2014 12:29:51 -0800 Subject: [PATCH] Clarify mail_handler.php setup instructions Summary: While not explicitly misleading, this document can do a better job of covering the common/modern case. Test Plan: Read document. Reviewers: rush898, btrahan Reviewed By: btrahan Subscribers: epriestley Differential Revision: https://secure.phabricator.com/D10783 --- .../configuring_inbound_email.diviner | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/src/docs/user/configuration/configuring_inbound_email.diviner b/src/docs/user/configuration/configuring_inbound_email.diviner index ba268eb7cc..cc6e85120f 100644 --- a/src/docs/user/configuration/configuring_inbound_email.diviner +++ b/src/docs/user/configuration/configuring_inbound_email.diviner @@ -199,11 +199,18 @@ probably means something like this: Now, you can actually configure sendmail to deliver to Phabricator. In `/etc/aliases`, add an entry like this: - phabricator: "| /path/to/phabricator/scripts/mail/mail_handler.php " + phabricator: "| /path/to/phabricator/scripts/mail/mail_handler.php" -...where is the PHABRICATOR_ENV the script should run under. Run -`sudo newaliases`. Now you likely need to symlink this script into -`/etc/smrsh/`: +If you use the `PHABRICATOR_ENV` environmental variable to select a +configuration, you can pass the value to the script as an argument: + + .../path/to/mail_handler.php + +This is an advanced feature which is rarely used. Most installs should run +without an argument. + +After making this change, run `sudo newaliases`. Now you likely need to symlink +this script into `/etc/smrsh/`: sudo ln -s /path/to/phabricator/scripts/mail/mail_handler.php /etc/smrsh/