From 8464d3a231f13fabaf1d1235070b629e25bfce2a Mon Sep 17 00:00:00 2001 From: medmunds Date: Fri, 8 Feb 2019 11:37:15 -0800 Subject: [PATCH] Docs: note SERVER_EMAIL setting default won't work with most ESPs mail_admins, mail_managers, and similar Django error reporting generally won't work with the default SERVER_EMAIL setting root@localhost. --- README.rst | 1 + docs/installation.rst | 7 ++++--- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/README.rst b/README.rst index 83cf041..5251ce4 100644 --- a/README.rst +++ b/README.rst @@ -100,6 +100,7 @@ or SparkPost or any other supported ESP where you see "mailgun": } EMAIL_BACKEND = "anymail.backends.mailgun.EmailBackend" # or sendgrid.EmailBackend, or... DEFAULT_FROM_EMAIL = "you@example.com" # if you don't already have this in settings + SERVER_EMAIL = "your-server@example.com" # ditto (default from-email for Django errors) 3. Now the regular `Django email functions `_ diff --git a/docs/installation.rst b/docs/installation.rst index aa4ae66..10413e8 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -68,9 +68,10 @@ planning to *receive* email.) use :ref:`multiple Anymail backends ` to send particular messages through different ESPs.) -2. If you don't already have a :setting:`DEFAULT_FROM_EMAIL` in your settings, - this is a good time to add one. (Django's default is "webmaster\@localhost", - which some ESPs will reject.) +2. If you don't already have :setting:`DEFAULT_FROM_EMAIL` and :setting:`SERVER_EMAIL` + in your settings, this is a good time to add them. (Django's defaults are + "webmaster\@localhost" and "root\@localhost", respectively, and most ESPs won't + allow sending from those addresses.) With the settings above, you are ready to send outgoing email through your ESP. If you also want to enable status tracking or inbound handling, continue with the