Page MenuHomePhabricator
Files F15492188

D20104.diff
No OneTemporary
Actions

D20104.diff
View Options

diff --git a/src/applications/config/option/PhabricatorMetaMTAConfigOptions.php b/src/applications/config/option/PhabricatorMetaMTAConfigOptions.php
--- a/src/applications/config/option/PhabricatorMetaMTAConfigOptions.php
+++ b/src/applications/config/option/PhabricatorMetaMTAConfigOptions.php
@@ -182,6 +182,25 @@
$mailers_description = $this->deformat(pht(<<<EODOC
Define one or more mail transmission services. For help with configuring
mailers, see **[[ %s | %s ]]** in the documentation.
+EODOC
+ ,
+ PhabricatorEnv::getDoclink('Configuring Outbound Email'),
+ pht('Configuring Outbound Email')));
+
+ $default_description = $this->deformat(pht(<<<EODOC
+Default address used as a "From" or "To" email address when an address is
+required but no meaningful address is available.
+
+If you configure inbound mail, you generally do not need to set this:
+Phabricator will automatically generate and use a suitable mailbox on the
+inbound mail domain.
+
+Otherwise, this option should be configured to point at a valid mailbox which
+discards all mail sent to it. If you point it at an invalid mailbox, mail sent
+by Phabricator and some mail sent by users will bounce. If you point it at a
+real user mailbox, that user will get a lot of mail they don't want.
+
+For further guidance, see **[[ %s | %s ]]** in the documentation.
EODOC
,
PhabricatorEnv::getDoclink('Configuring Outbound Email'),
@@ -192,7 +211,9 @@
->setHidden(true)
->setDescription($mailers_description),
$this->newOption('metamta.default-address', 'string', null)
- ->setDescription(pht('Default "From" address.')),
+ ->setLocked(true)
+ ->setSummary(pht('Default address used when generating mail.'))
+ ->setDescription($default_description),
$this->newOption(
'metamta.one-mail-per-recipient',
'bool',
diff --git a/src/docs/user/configuration/configuring_outbound_email.diviner b/src/docs/user/configuration/configuring_outbound_email.diviner
--- a/src/docs/user/configuration/configuring_outbound_email.diviner
+++ b/src/docs/user/configuration/configuring_outbound_email.diviner
@@ -47,18 +47,31 @@
@{article:Managing Daemons with phd}.
-Basics
-======
-
-Before configuring outbound mail, you should first set up
-`metamta.default-address` in Configuration. This determines where mail is sent
-"From" by default.
-
-If your domain is `example.org`, set this to something
-like `noreply@example.org`.
-
-Ideally, this should be a valid, deliverable address that doesn't bounce if
-users accidentally send mail to it.
+Outbound "From" and "To" Addresses
+==================================
+
+When Phabricator sends outbound mail, it must select some "From" address to
+send mail from, since mailers require this.
+
+When mail only has "CC" recipients, Phabricator generates a dummy "To" address,
+since some mailers require this and some users write mail rules that depend
+on whether they appear in the "To" or "CC" line.
+
+In both cases, the address should ideally correspond to a valid, deliverable
+mailbox that accepts the mail and then simply discards it. If the address is
+not valid, some outbound mail will bounce, and users will receive bounces when
+they "Reply All" even if the other recipients for the message are valid. In
+contrast, if the address is a real user address, that user will receive a lot
+of mail they probably don't want.
+
+If you plan to configure //inbound// mail later, you usually don't need to do
+anything. Phabricator will automatically create a `noreply@` mailbox which
+works the right way (accepts and discards all mail it receives) and
+automatically use it when generating addresses.
+
+If you don't plan to configure inbound mail, you may need to configure an
+address for Phabricator to use. You can do this by setting
+`metamta.default-address`.
Configuring Mailers

File Metadata

Mime Type
text/plain
Expires
Sun, Apr 13, 12:09 PM (6 d, 11 m ago)
Storage Engine
blob
Storage Format
Encrypted (AES-256-CBC)
Storage Handle
7390491
Default Alt Text
D20104.diff (3 KB)

Event Timeline

Phabricator · Built by Phacility