aboutsummaryrefslogtreecommitdiffstats
path: root/doc/INSTALL-exim4.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/INSTALL-exim4.md')
-rw-r--r--doc/INSTALL-exim4.md30
1 files changed, 29 insertions, 1 deletions
diff --git a/doc/INSTALL-exim4.md b/doc/INSTALL-exim4.md
index 6a0e1247e..69844d2e1 100644
--- a/doc/INSTALL-exim4.md
+++ b/doc/INSTALL-exim4.md
@@ -5,6 +5,13 @@ In `/etc/exim4/conf.d/main/04_alaveteli_options`:
ALAVETELI_HOME=/path/to/alaveteli/software
ALAVETELI_USER=www-data
+ log_file_path=/var/log/exim4/exim-%slog-%D
+
+(The user ALAVETELI_USER should have write permissions on ALAVETELI_HOME).
+
+Note that the name and location of the log files created by Exim must match
+what the script `load-exim-logs` expects, hence the need for the extra
+`log_file_path` setting.
In `/etc/exim4/conf.d/router/04_alaveteli`:
@@ -17,7 +24,7 @@ In `/etc/exim4/conf.d/router/04_alaveteli`:
In `/etc/exim4/conf.d/transport/04_alaveteli`:
alaveteli_mailin_transport:
- driver = pipe
+ driver = pipe
command = $address_pipe ${lc:$local_part}
current_directory = ALAVETELI_HOME
home_directory = ALAVETELI_HOME
@@ -30,6 +37,23 @@ content:
^foi\\+.*: |/path/to/alaveteli/software/script/mailin
+You should also configure exim to discard any messages sent to the `BLACKHOLE_PREFIX`
+address, whose default value is 'do-not-reply-to-this-address'. For example, add the
+following to config/aliases:
+
+ # We use this for envelope from for some messages where we don't care about delivery
+ do-not-reply-to-this-address: :blackhole:
+
+If you want to make use of the automatic bounce-message handling, then set the `TRACK_SENDER_EMAIL`
+address to be filtered through `script/handle-mail-replies`. Messages that are not bounces or
+out-of-office autoreplies will be forwarded to `FORWARD_NONBOUNCE_RESPONSES_TO`. For example,
+in WhatDoTheyKnow the configuration looks like this:
+
+ raw_team: [a list of people on the team]
+ team: |/path/to/alaveteli/software/script/handle-mail-replies
+
+with `FORWARD_NONBOUNCE_RESPONSES_TO: 'raw_team@whatdotheyknow.com'`
+
Finally, make sure you have `dc_use_split_config='true'` in
`/etc/exim4/update-exim4.conf.conf`, and execute the command
`update-exim4.conf`
@@ -51,3 +75,7 @@ see something like:
R: alaveteli pipe for snafflerequest-234@localhost
snafflerequest-234@localhost -> |/home/alaveteli/alaveteli/script/mailin
transport = alaveteli_mailin_transport
+
+There is a great
+[Exim Cheatsheet](http://bradthemad.org/tech/notes/exim_cheatsheet.php)
+online that you may find useful.