diff options
author | Gareth Rees <gareth@mysociety.org> | 2014-07-18 16:00:44 +0100 |
---|---|---|
committer | Gareth Rees <gareth@mysociety.org> | 2014-08-21 17:37:38 +0100 |
commit | ebe9fb00cd2ed43351b2672d9aadf846681dcbbe (patch) | |
tree | 58dbf6e8586b6251e550f5171361ec77f1eced3e | |
parent | 1fcd24708a3cf27daee67057b9f9d241d86f4c4d (diff) |
Remove email configuration
This has a separate guide so link to that.
The guide here just leaves a half-installed MTA so its bound to cause trouble. We can include a brief guide in the installing MTA docs if desired.
-rw-r--r-- | docs/installing/manual_install.md | 41 |
1 files changed, 3 insertions, 38 deletions
diff --git a/docs/installing/manual_install.md b/docs/installing/manual_install.md index 394ca7b29..9748d894b 100644 --- a/docs/installing/manual_install.md +++ b/docs/installing/manual_install.md @@ -300,45 +300,10 @@ You will need to set up an email server (MTA) to send and receive emails. Full configuration for an MTA is beyond the scope of this document -- see this [example configs for Exim4 and Postfix]({{ site.baseurl }}docs/installing/email/). -Note that in development mode mail is handled by mailcatcher by default so -that you can see the mails in a browser - see [http://mailcatcher.me/](http://mailcatcher.me/) for more -details. Start mailcatcher by running `bundle exec mailcatcher` in your -application directory. +Full configuration for an MTA is beyond the scope of this document -- see the guide for [configuring the Exim4 or Postfix MTAs]({{ site.baseurl }}docs/installing/email/). -### Minimal - -If you just want to get the tests to pass, you will at a minimum need to allow -sending emails via a `sendmail` command (a requirement met, for example, with -`apt-get install exim4`). - -### Detailed - -When an authority receives an email, the email's `reply-to` field is a magic -address which is parsed and consumed by the Rails app. - -To receive such email in a production setup, you will need to configure your -MTA to pipe incoming emails to the Alaveteli script `script/mailin`. Therefore, -you will need to configure your MTA to accept emails to magic addresses, and to -pipe such emails to this script. - -Magic email addresses are of the form: - - <foi+request-3-691c8388@example.com> - -The respective parts of this address are controlled with options in -`config/general.yml`, thus: - - INCOMING_EMAIL_PREFIX = 'foi+' - INCOMING_EMAIL_DOMAIN = 'example.com' - -When you set up your MTA, if there is some error inside Rails, the -email is returned with an exit code 75, which for Exim at least means the MTA -will try again later. Additionally, a stacktrace is emailed to `CONTACT_EMAIL`. - -See [this example]({{ site.baseurl }}docs/installing/email/) for a possible configuration for Exim (>=1.9). - -A well-configured installation of this code will have had Exim make -a backup copy of the email in a separate mailbox, just in case. +Note that in development mode mail is handled by [`mailcatcher`](http://mailcatcher.me/) by default so +that you can see the mails in a browser. Start mailcatcher by running `bundle exec mailcatcher` in the application directory. ## Set up configs |