From 05245871f4bd5edfa62d0251d270f030c72f8efc Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 7 Aug 2014 13:54:34 +0100 Subject: Add package install --- docs/installing/email.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 98dff0087..7675b908a 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -108,6 +108,10 @@ This section shows an example of how to set up your MTA if you're using ### Instructions +Install exim4: + + apt-get install exim4 + We suggest you add the following to your exim configuration. In `/etc/exim4/conf.d/main/04_alaveteli_options`, set: -- cgit v1.2.3 From c4d4ec771cdfe52ceae7e647030e0f77e686adfb Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 7 Aug 2014 14:20:45 +0100 Subject: Use default alaveteli path. --- docs/installing/email.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 7675b908a..a691e7065 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -116,13 +116,13 @@ We suggest you add the following to your exim configuration. In `/etc/exim4/conf.d/main/04_alaveteli_options`, set: - ALAVETELI_HOME=/path/to/alaveteli/software - ALAVETELI_USER=www-data + ALAVETELI_HOME=/var/www/alaveteli + ALAVETELI_USER=alaveteli log_file_path=/var/log/exim4/exim-%slog-%D MAIN_LOG_SELECTOR==+all -retry_defer extract_addresses_remove_arguments=false -The user ALAVETELI_USER should have write permissions on ALAVETELI_HOME. +The `ALAVETELI_HOME` variable should be set to the directory where Alaveteli is installed. `ALAVETELI_USER` should be the Unix user that is going to run your site. They should have write permissions on `ALAVETELI_HOME`. The name and location of the log files created by Exim must match what the `load-mail-server-logs` script expects, which is why you must provide the @@ -157,7 +157,7 @@ And, assuming you set in your config at `config/general.yml` to "foi+", create `config/aliases` with the following content: - ^foi\\+.*: |/path/to/alaveteli/software/script/mailin + ^foi\\+.*: |/var/www/alaveteli/script/mailin You should also configure exim to discard any messages sent to the [`BLACKHOLE_PREFIX`]({{ site.baseurl }}docs/customising/config/#blackhole_prefix) @@ -177,10 +177,10 @@ out-of-office autoreplies will be forwarded 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 + real_team: [a list of people on the team] + team: |/var/www/alaveteli/script/handle-mail-replies -with `FORWARD_NONBOUNCE_RESPONSES_TO`: 'raw_team@whatdotheyknow.com'` +with `FORWARD_NONBOUNCE_RESPONSES_TO`: 'real_team@whatdotheyknow.com'` Finally, make sure you have `dc_use_split_config='true'` in `/etc/exim4/update-exim4.conf.conf`, and execute the command -- cgit v1.2.3 From 49c97aa91c7260bd092cf58692f267ed8f25b8e3 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 7 Aug 2014 14:21:38 +0100 Subject: More explanation of dc_use_split_config --- docs/installing/email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index a691e7065..a7fc9f16a 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -183,7 +183,7 @@ configuration looks like this: with `FORWARD_NONBOUNCE_RESPONSES_TO`: 'real_team@whatdotheyknow.com'` Finally, make sure you have `dc_use_split_config='true'` in -`/etc/exim4/update-exim4.conf.conf`, and execute the command +`/etc/exim4/update-exim4.conf.conf` so that exim uses the files in `/etc/exim4/conf.d` to configure itself, and execute the command `update-exim4.conf`. Note that if the file `/etc/exim4/exim4.conf` exists then `update-exim4.conf` -- cgit v1.2.3 From f39ab701b180202d719094f526d889d24bd06184 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 7 Aug 2014 14:22:31 +0100 Subject: Use example.com as example domain --- docs/installing/email.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index a7fc9f16a..8129cd689 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -192,24 +192,25 @@ yours does, you will need to rename it before running `update-exim4.conf`. (You may also want to set `dc_eximconfig_configtype='internet'`, `dc_local_interfaces='0.0.0.0 ; ::1'`, and -`dc_other_hostnames=''`). +`dc_other_hostnames='example.com'` - using your domain name, not `example.com`). + ### Troubleshooting (exim) To test mail delivery, run: - exim -bt foi+request-1234@localhost + exim4 -bt foi+request-1234@example.com -This should tell you which routers are being processed. You should +replacing `example.com` with your domain name. This should tell you which routers are being processed. You should see something like: - $ exim -bt foi+request-1234@localhost - R: alaveteli pipe for snafflerequest-234@localhost - snafflerequest-234@localhost -> |/home/alaveteli/alaveteli/script/mailin - transport = alaveteli_mailin_transport + $ exim4 -bt foi+request-1234@localhost + R: alaveteli for foi+request-1234@example.com + foi+request-1234@example.com -> |/var/www/alaveteli/script/mailin + transport = alaveteli_mailin_transport This tells you that the routing part (making emails to -`foi\+.*@localhost` be forwarded to Alaveteli's `mailin` script) is +`foi\+.*@example.com` be forwarded to Alaveteli's `mailin` script) is working. There is a great -- cgit v1.2.3 From 73ebe4cf8636d55e308758cf55df5708a9d50b52 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 7 Aug 2014 14:22:46 +0100 Subject: Needs to be privileged --- docs/installing/email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 8129cd689..d9dc7880a 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -197,7 +197,7 @@ yours does, you will need to rename it before running `update-exim4.conf`. ### Troubleshooting (exim) -To test mail delivery, run: +To test mail delivery, as a privileged user run: exim4 -bt foi+request-1234@example.com -- cgit v1.2.3 From 0f1f8d97ed0bda9da136c10b37f80aad3db77468 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 7 Aug 2014 14:48:22 +0100 Subject: Just give a suggested example, don't refer to WDTK --- docs/installing/email.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index d9dc7880a..563b98cb5 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -174,13 +174,14 @@ 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`]({{ site.baseurl }}docs/customising/config/#forward_nonbounce_responses_to). -For example, in WhatDoTheyKnow the -configuration looks like this: +For example, you could add the following to `config/aliases`: real_team: [a list of people on the team] team: |/var/www/alaveteli/script/handle-mail-replies -with `FORWARD_NONBOUNCE_RESPONSES_TO`: 'real_team@whatdotheyknow.com'` +In your Alaveteli `config/general.yml` file you would have (replacing `example.com` with your domain): + + FORWARD_NONBOUNCE_RESPONSES_TO: 'real_team@example.com' Finally, make sure you have `dc_use_split_config='true'` in `/etc/exim4/update-exim4.conf.conf` so that exim uses the files in `/etc/exim4/conf.d` to configure itself, and execute the command -- cgit v1.2.3 From 0b69c30d1415649c08208f01c8ed53e07855370e Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 13:44:52 +0100 Subject: Add section on recipient groups --- docs/installing/email.md | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 563b98cb5..a5afddd53 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -158,6 +158,12 @@ in your config at `config/general.yml` to "foi+", create `config/aliases` with t content: ^foi\\+.*: |/var/www/alaveteli/script/mailin +#### Set up your contact email recipient groups + +To set up recipient groups for the `team@` and `user-support@` email addresses at your domain, add alias records for them in `/var/www/alaveteli/config/etc/aliases` + + team: user@example.com, otheruser@example.com + user-support: team You should also configure exim to discard any messages sent to the [`BLACKHOLE_PREFIX`]({{ site.baseurl }}docs/customising/config/#blackhole_prefix) -- cgit v1.2.3 From 1a076552cfbf0aff636c1b8ec100ae189b17006f Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 16:29:49 +0100 Subject: Add not on privileges and ssh/terminal access. --- docs/installing/email.md | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index a5afddd53..300c20036 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -11,6 +11,14 @@ title: Installing MTA here for both postfix and exim4, two of the most popular MTAs.

+
+
    +
  • Commands in this guide will require root privileges
    • +
  • Commands are intended to be run via the terminal or over ssh
    • +
+
+ + Make sure you follow the correct instructions for the specific MTA you're using: * [postfix](#example-setup-on-postfix) -- cgit v1.2.3 From e35426bd5adb6fb003f718f25baab73763134563 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 16:31:10 +0100 Subject: Add better headings, start with basic configuration --- docs/installing/email.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 300c20036..f62c1f3ce 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -114,15 +114,26 @@ This section shows an example of how to set up your MTA if you're using [postfix](#example-setup-on-postfix) if you're using that instead of exim4. -### Instructions +### Install exim4 Install exim4: apt-get install exim4 -We suggest you add the following to your exim configuration. -In `/etc/exim4/conf.d/main/04_alaveteli_options`, set: +### Configure exim4 + +#### Set up exim to receive mail from other servers + +Edit `/etc/exim4/update-exim4.conf.conf`. Set the following settings (use your hostname, not `example.com`): + + dc_eximconfig_configtype='internet' + dc_other_hostnames='example.com' + dc_local_interfaces='0.0.0.0 ; ::1' + dc_use_split_config='true' + +This final line tells exim to use the files in `/etc/exim4/conf.d` to configure itself. + ALAVETELI_HOME=/var/www/alaveteli ALAVETELI_USER=alaveteli -- cgit v1.2.3 From 66251c24c54775f74e2edbc6099ebfd8ce88539a Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 18:27:25 +0100 Subject: Don't specify OS - we support Debian/Ubuntu. --- docs/installing/email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index f62c1f3ce..806b467d8 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -110,7 +110,7 @@ This tells you if sending the emails to `foi\+.*localhost` is working. ## Example setup on exim4 This section shows an example of how to set up your MTA if you're using -**exim4** (running on Ubuntu). See the example for +**exim4**. See the example for [postfix](#example-setup-on-postfix) if you're using that instead of exim4. -- cgit v1.2.3 From b8d5a377ada7e83ca96c2b8b68ebcfea67e5f887 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 18:30:45 +0100 Subject: Make command cut-and-pastable. Better description of options --- docs/installing/email.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 806b467d8..f47c0dc6a 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -134,14 +134,21 @@ Edit `/etc/exim4/update-exim4.conf.conf`. Set the following settings (use your h This final line tells exim to use the files in `/etc/exim4/conf.d` to configure itself. +#### Define general variables and logging settings +Create `/etc/exim4/conf.d/main/04_alaveteli_options` with the command: + + cat > /etc/exim4/conf.d/main/04_alaveteli_options <<'EOF' ALAVETELI_HOME=/var/www/alaveteli ALAVETELI_USER=alaveteli log_file_path=/var/log/exim4/exim-%slog-%D MAIN_LOG_SELECTOR==+all -retry_defer extract_addresses_remove_arguments=false + EOF + +This sets up `ALAVETELI_HOME` and `ALAVETELI_USER` for use in other config files, and sets up logging. The `ALAVETELI_HOME` variable should be set to the directory where Alaveteli is installed. `ALAVETELI_USER` should be the Unix user that is going to run your site. They should have write permissions on `ALAVETELI_HOME`. -The `ALAVETELI_HOME` variable should be set to the directory where Alaveteli is installed. `ALAVETELI_USER` should be the Unix user that is going to run your site. They should have write permissions on `ALAVETELI_HOME`. +Note that if you are editing an existing exim config that restricts the `untrusted_set_sender` option, you will need also to add `ALAVETELI_USER` to the `trusted_users` list in order to allow them to set the return path on outgoing mail. This option is in `/etx/exim4/conf.d/main/02_exim4-config_options` in a split config. The name and location of the log files created by Exim must match what the `load-mail-server-logs` script expects, which is why you must provide the -- cgit v1.2.3 From 49251ad5b99d2c231668ffd6c0b8437263da56bf Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 18:32:04 +0100 Subject: Make commands cut-and-pastable --- docs/installing/email.md | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index f47c0dc6a..7c8de4a9e 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -156,20 +156,25 @@ The name and location of the log files created by Exim must match what the The `check-recent-requests-sent` scripts expects the logs to contain the `from=<...>` envelope information, so we make the logs more verbose with -`log_selector`. The ALAVETELI_USER may need to also need to be added to the -`trusted_users` list in your Exim config in order to set the return path on -outgoing mail, depending on your setup. +`MAIN_LOG_SELECTOR`. -In `/etc/exim4/conf.d/router/04_alaveteli`: +Setting `extract_addresses_remove_arguments` to `false` gets exim to treat the `-t` command line option that the `mail` gem uses when specifying delivery addresses on the command line as specifying that the addresses should be added, not removed. See [this `mail` issue](https://github.com/mikel/mail/issues/70) for more details. +#### Pipe incoming mail for requests from Exim to Alaveteli + +Create `/etc/exim4/conf.d/router/04_alaveteli`: + + cat > /etc/exim4/conf.d/router/04_alaveteli <<'EOF' alaveteli_request: debug_print = "R: alaveteli for $local_part@$domain" driver = redirect data = ${lookup{$local_part}wildlsearch{ALAVETELI_HOME/config/aliases}} pipe_transport = alaveteli_mailin_transport + EOF -In `/etc/exim4/conf.d/transport/04_alaveteli`: +Create `/etc/exim4/conf.d/transport/04_alaveteli`: + cat > /etc/exim4/conf.d/transport/04_alaveteli <<'EOF' alaveteli_mailin_transport: driver = pipe command = $address_pipe ${lc:$local_part} @@ -177,13 +182,16 @@ In `/etc/exim4/conf.d/transport/04_alaveteli`: home_directory = ALAVETELI_HOME user = ALAVETELI_USER group = ALAVETELI_USER + EOF And, assuming you set [`INCOMING_EMAIL_PREFIX`]({{ site.baseurl }}docs/customising/config/#incoming_email_prefix) in your config at `config/general.yml` to "foi+", create `config/aliases` with the following -content: +command: + cat > /var/www/alaveteli/config/aliases <<'EOF' ^foi\\+.*: |/var/www/alaveteli/script/mailin + EOF #### Set up your contact email recipient groups To set up recipient groups for the `team@` and `user-support@` email addresses at your domain, add alias records for them in `/var/www/alaveteli/config/etc/aliases` -- cgit v1.2.3 From bcdb2dbeb640740c8ffceb8bc1af1872db4ae701 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 18:32:36 +0100 Subject: Add path note --- docs/installing/email.md | 3 +++ 1 file changed, 3 insertions(+) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 7c8de4a9e..8206b5147 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -192,6 +192,9 @@ command: cat > /var/www/alaveteli/config/aliases <<'EOF' ^foi\\+.*: |/var/www/alaveteli/script/mailin EOF + +That's assuming that Alaveteli is running from `/var/www/alaveteli`. If it isn't, substitute the path it is running from. + #### Set up your contact email recipient groups To set up recipient groups for the `team@` and `user-support@` email addresses at your domain, add alias records for them in `/var/www/alaveteli/config/etc/aliases` -- cgit v1.2.3 From 0a638b0e6138e7361bd3e8fc8105496ef5ce88cf Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 18:33:17 +0100 Subject: Better description of bounce handling, making live. --- docs/installing/email.md | 34 ++++++++++++++-------------------- 1 file changed, 14 insertions(+), 20 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 8206b5147..fc59759fa 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -211,35 +211,29 @@ address, whose default value is # 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`]({{ site.baseurl }}docs/customising/config/#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`]({{ site.baseurl }}docs/customising/config/#forward_nonbounce_responses_to). -For example, you could add the following to `config/aliases`: +#### Filter incoming messages to admin addresses - real_team: [a list of people on the team] - team: |/var/www/alaveteli/script/handle-mail-replies +As described in ['Other mail']({{site.baseurl}}docs/installing/email#other-mail) you can make use of the script that filters mail to [`TRACK_SENDER_EMAIL`]({{site.baseurl}}docs/customising/config/#track_sender_email) and [`CONTACT_EMAIL`]({{site.baseurl}}docs/customising/config/#contact_email) for bounce messages before delivering it to your admin team. +To do this, for a `general.yml` file +that sets those addresses to `user-support@example.com` and +[`FORWARD_NONBOUNCE_RESPONSES_TO`]({{site.baseurl}}docs/customising/config/#forward_nonbounce_responses_to) to +`team@example.com`, update the `user-support` line in `/var/www/alaveteli/config/aliases`: -In your Alaveteli `config/general.yml` file you would have (replacing `example.com` with your domain): + user-support: |/var/www/alaveteli/script/handle-mail-replies - FORWARD_NONBOUNCE_RESPONSES_TO: 'real_team@example.com' +#### Making the changes live in exim -Finally, make sure you have `dc_use_split_config='true'` in -`/etc/exim4/update-exim4.conf.conf` so that exim uses the files in `/etc/exim4/conf.d` to configure itself, and execute the command -`update-exim4.conf`. +Finally, execute the command: + + update-exim4.conf + service exim4 restart Note that if the file `/etc/exim4/exim4.conf` exists then `update-exim4.conf` will silently do nothing. Some distributions include this file. If -yours does, you will need to rename it before running `update-exim4.conf`. - -(You may also want to set `dc_eximconfig_configtype='internet'`, -`dc_local_interfaces='0.0.0.0 ; ::1'`, and -`dc_other_hostnames='example.com'` - using your domain name, not `example.com`). +yours does, you will need to remove or rename it before running `update-exim4.conf`. -### Troubleshooting (exim) +#### Troubleshooting (exim) To test mail delivery, as a privileged user run: -- cgit v1.2.3 From a1b2f82645b04ea7eab3247721c5cee6c08697ad Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 11 Aug 2014 18:33:53 +0100 Subject: Add testing of bounce handling --- docs/installing/email.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index fc59759fa..23889dcbd 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -242,14 +242,19 @@ To test mail delivery, as a privileged user run: replacing `example.com` with your domain name. This should tell you which routers are being processed. You should see something like: - $ exim4 -bt foi+request-1234@localhost + $ exim4 -bt foi+request-1234@example.com R: alaveteli for foi+request-1234@example.com foi+request-1234@example.com -> |/var/www/alaveteli/script/mailin transport = alaveteli_mailin_transport This tells you that the routing part (making emails to `foi\+.*@example.com` be forwarded to Alaveteli's `mailin` script) is -working. +working. You can test bounce message routing in the same way: + + exim4 -bt user-support@example.com + R: alaveteli for user-support@example.com + user-support@example.com -> |/var/www/alaveteli/script/handle-mail-replies + transport = alaveteli_mailin_transport There is a great [Exim Cheatsheet](http://bradthemad.org/tech/notes/exim_cheatsheet.php) -- cgit v1.2.3 From 7a7bac68f57e8800135a1513c484619245fa69b9 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Tue, 12 Aug 2014 11:07:02 +0100 Subject: Add instructions for backup to a separate mailbox --- docs/installing/email.md | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 23889dcbd..92980f7bb 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -162,7 +162,9 @@ Setting `extract_addresses_remove_arguments` to `false` gets exim to treat the ` #### Pipe incoming mail for requests from Exim to Alaveteli -Create `/etc/exim4/conf.d/router/04_alaveteli`: +In this section, we'll add config to pipe incoming mail for special +Alaveteli addresses into Alaveteli, and also send them to a local backup +mailbox, just in case. Create the `backupfoi` UNIX user, and then create `/etc/exim4/conf.d/router/04_alaveteli`: cat > /etc/exim4/conf.d/router/04_alaveteli <<'EOF' alaveteli_request: @@ -190,7 +192,7 @@ in your config at `config/general.yml` to "foi+", create `config/aliases` with t command: cat > /var/www/alaveteli/config/aliases <<'EOF' - ^foi\\+.*: |/var/www/alaveteli/script/mailin + ^foi\\+.*: "|/var/www/alaveteli/script/mailin", backupfoi EOF That's assuming that Alaveteli is running from `/var/www/alaveteli`. If it isn't, substitute the path it is running from. @@ -246,10 +248,21 @@ see something like: R: alaveteli for foi+request-1234@example.com foi+request-1234@example.com -> |/var/www/alaveteli/script/mailin transport = alaveteli_mailin_transport + R: alaveteli for backupfoi@your.machine.name + R: system_aliases for backupfoi@your.machine.name + R: userforward for backupfoi@your.machine.name + R: procmail for backupfoi@your.machine.name + R: maildrop for backupfoi@your.machine.name + R: lowuid_aliases for backupfoi@your.machine.name (UID 1001) + R: local_user for backupfoi@your.machine.name + backupfoi@your.machine.name + <-- foi+request-1234@example.com + router = local_user, transport = mail_spool This tells you that the routing part (making emails to -`foi\+.*@example.com` be forwarded to Alaveteli's `mailin` script) is -working. You can test bounce message routing in the same way: +`foi\+.*@example.com` be forwarded to Alaveteli's `mailin` script, and +also sent to the local backup account) is working. You can test bounce +message routing in the same way: exim4 -bt user-support@example.com R: alaveteli for user-support@example.com -- cgit v1.2.3 From 1f964b3e67399ae4e9c6b522950bf7ea967cd267 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 18 Aug 2014 15:57:18 +0100 Subject: Add more detail to the different parts of the delivery process in exim --- docs/installing/email.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 92980f7bb..87915315f 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -164,7 +164,7 @@ Setting `extract_addresses_remove_arguments` to `false` gets exim to treat the ` In this section, we'll add config to pipe incoming mail for special Alaveteli addresses into Alaveteli, and also send them to a local backup -mailbox, just in case. Create the `backupfoi` UNIX user, and then create `/etc/exim4/conf.d/router/04_alaveteli`: +mailbox, just in case. Create the `backupfoi` UNIX user, and then create `/etc/exim4/conf.d/router/04_alaveteli` to specify an exim `router` for special Alaveteli addresses, which will route messages into Alaveteli using a local pipe transport: cat > /etc/exim4/conf.d/router/04_alaveteli <<'EOF' alaveteli_request: @@ -174,7 +174,7 @@ mailbox, just in case. Create the `backupfoi` UNIX user, and then create `/etc/e pipe_transport = alaveteli_mailin_transport EOF -Create `/etc/exim4/conf.d/transport/04_alaveteli`: +Create `/etc/exim4/conf.d/transport/04_alaveteli`, which sets the properties of the pipe `transport` that will deliver mail to Alaveteli: cat > /etc/exim4/conf.d/transport/04_alaveteli <<'EOF' alaveteli_mailin_transport: @@ -186,10 +186,11 @@ Create `/etc/exim4/conf.d/transport/04_alaveteli`: group = ALAVETELI_USER EOF -And, assuming you set -[`INCOMING_EMAIL_PREFIX`]({{ site.baseurl }}docs/customising/config/#incoming_email_prefix) -in your config at `config/general.yml` to "foi+", create `config/aliases` with the following -command: +And, assuming you set [`INCOMING_EMAIL_PREFIX`]({{ site.baseurl }}docs/customising/config/#incoming_email_prefix) in your config at +`config/general.yml` to "foi+", create `config/aliases` with the +following command. This defines the special addresses that the `router` +and `transport` will apply to with a regular expression. It also defines +the pipe command to be used: cat > /var/www/alaveteli/config/aliases <<'EOF' ^foi\\+.*: "|/var/www/alaveteli/script/mailin", backupfoi -- cgit v1.2.3 From 53806f8341275991e966efb55ed6d727552f0620 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 18 Aug 2014 16:15:05 +0100 Subject: More explanation of untrusted_set_sender. --- docs/installing/email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 87915315f..54f6d0c76 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -148,7 +148,7 @@ Create `/etc/exim4/conf.d/main/04_alaveteli_options` with the command: This sets up `ALAVETELI_HOME` and `ALAVETELI_USER` for use in other config files, and sets up logging. The `ALAVETELI_HOME` variable should be set to the directory where Alaveteli is installed. `ALAVETELI_USER` should be the Unix user that is going to run your site. They should have write permissions on `ALAVETELI_HOME`. -Note that if you are editing an existing exim config that restricts the `untrusted_set_sender` option, you will need also to add `ALAVETELI_USER` to the `trusted_users` list in order to allow them to set the return path on outgoing mail. This option is in `/etx/exim4/conf.d/main/02_exim4-config_options` in a split config. +Note: If you are editing an existing exim config rather than creating a new one, check the `untrusted_set_sender` option in `/etc/exim4/conf.d/main/02_exim4-config_options`. By default, untrusted users in exim are only allowed to set an empty envelope sender address, to declare that a message should never generate any bounces. `untrusted_set_sender` can be set to a list of address patterns, meaning that untrusted users are allowed to set envelope sender addresses that match any of the patterns in the list. If a pattern list is specified, you will need also to add `ALAVETELI_USER` to the `trusted_users` list in order to allow them to set the return path on outgoing mail. This option is also in `/etc/exim4/conf.d/main/02_exim4-config_options` in a split config. If `untrusted_set_sender` is set to `*`, that means that untrusted users can set envelope sender addresses without restriction, so there's no need to add `ALAVETELI_USER` to the `trusted_users` list. The name and location of the log files created by Exim must match what the `load-mail-server-logs` script expects, which is why you must provide the -- cgit v1.2.3 From 9aafc0daf0da4e1dd56f721398c1318deb421d18 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 18 Aug 2014 16:29:24 +0100 Subject: Use attention box for existing config note. --- docs/installing/email.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 54f6d0c76..7422bd7a2 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -148,7 +148,17 @@ Create `/etc/exim4/conf.d/main/04_alaveteli_options` with the command: This sets up `ALAVETELI_HOME` and `ALAVETELI_USER` for use in other config files, and sets up logging. The `ALAVETELI_HOME` variable should be set to the directory where Alaveteli is installed. `ALAVETELI_USER` should be the Unix user that is going to run your site. They should have write permissions on `ALAVETELI_HOME`. -Note: If you are editing an existing exim config rather than creating a new one, check the `untrusted_set_sender` option in `/etc/exim4/conf.d/main/02_exim4-config_options`. By default, untrusted users in exim are only allowed to set an empty envelope sender address, to declare that a message should never generate any bounces. `untrusted_set_sender` can be set to a list of address patterns, meaning that untrusted users are allowed to set envelope sender addresses that match any of the patterns in the list. If a pattern list is specified, you will need also to add `ALAVETELI_USER` to the `trusted_users` list in order to allow them to set the return path on outgoing mail. This option is also in `/etc/exim4/conf.d/main/02_exim4-config_options` in a split config. If `untrusted_set_sender` is set to `*`, that means that untrusted users can set envelope sender addresses without restriction, so there's no need to add `ALAVETELI_USER` to the `trusted_users` list. +
+Note: If you are editing an existing exim config rather than creating a new one, check the untrusted_set_sender option in /etc/exim4/conf.d/main/02_exim4-config_options. By default, untrusted users in exim are only allowed to set an empty envelope sender address, to declare that a message should never generate any bounces. untrusted_set_sender can be set to a list of address patterns, meaning that untrusted users are allowed to set envelope sender addresses that match any of the patterns in the list. If a pattern list is specified, you will need also to add ALAVETELI_USER to the MAIN_TRUSTED_USERS list in order to allow them to set the return path on outgoing mail. This option is also in /etc/exim4/conf.d/main/02_exim4-config_options in a split config. Look for the line that begins with MAIN_TRUSTED_USERS - something like: + + 
MAIN_TRUSTED_USERS = uucp
+ +and add the alaveteli user: + + 
MAIN_TRUSTED_USERS = uucp : alaveteli
+ + If untrusted_set_sender is set to *, that means that untrusted users can set envelope sender addresses without restriction, so there's no need to add ALAVETELI_USER to the MAIN_TRUSTED_USERS list. +
The name and location of the log files created by Exim must match what the `load-mail-server-logs` script expects, which is why you must provide the -- cgit v1.2.3 From 4fb62304e89afd4a92a5cfdf085604cdcf599304 Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 12:11:10 +0100 Subject: Omit needless words --- docs/installing/email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 7422bd7a2..7c36db56d 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -174,7 +174,7 @@ Setting `extract_addresses_remove_arguments` to `false` gets exim to treat the ` In this section, we'll add config to pipe incoming mail for special Alaveteli addresses into Alaveteli, and also send them to a local backup -mailbox, just in case. Create the `backupfoi` UNIX user, and then create `/etc/exim4/conf.d/router/04_alaveteli` to specify an exim `router` for special Alaveteli addresses, which will route messages into Alaveteli using a local pipe transport: +mailbox. Create the `backupfoi` UNIX user, and then create `/etc/exim4/conf.d/router/04_alaveteli` to specify an exim `router` for special Alaveteli addresses, which will route messages into Alaveteli using a local pipe transport: cat > /etc/exim4/conf.d/router/04_alaveteli <<'EOF' alaveteli_request: -- cgit v1.2.3 From 11648bc678ff05c3d677030b1ae8bdd752338078 Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 12:15:51 +0100 Subject: Instructions to create the backupfoi user --- docs/installing/email.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 7c36db56d..e443ed1bb 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -174,7 +174,14 @@ Setting `extract_addresses_remove_arguments` to `false` gets exim to treat the ` In this section, we'll add config to pipe incoming mail for special Alaveteli addresses into Alaveteli, and also send them to a local backup -mailbox. Create the `backupfoi` UNIX user, and then create `/etc/exim4/conf.d/router/04_alaveteli` to specify an exim `router` for special Alaveteli addresses, which will route messages into Alaveteli using a local pipe transport: +mailbox. + +Create the `backupfoi` UNIX user + + adduser --quiet --disabled-password \ + --gecos "Alaveteli Mail Backup" backupfoi + +Specify an exim `router` for special Alaveteli addresses, which will route messages into Alaveteli using a local pipe transport: cat > /etc/exim4/conf.d/router/04_alaveteli <<'EOF' alaveteli_request: -- cgit v1.2.3 From 842bd85d87262ace3f7b79bad8c7e37303bf6bee Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 12:23:59 +0100 Subject: Consistency with postfix guide --- docs/installing/email.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index e443ed1bb..775e45ffa 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -203,17 +203,18 @@ Create `/etc/exim4/conf.d/transport/04_alaveteli`, which sets the properties of group = ALAVETELI_USER EOF -And, assuming you set [`INCOMING_EMAIL_PREFIX`]({{ site.baseurl }}docs/customising/config/#incoming_email_prefix) in your config at -`config/general.yml` to "foi+", create `config/aliases` with the -following command. This defines the special addresses that the `router` -and `transport` will apply to with a regular expression. It also defines -the pipe command to be used: + +
+ This guide assumes you have set INCOMING_EMAIL_PREFIX to foi+ in config/general.yml +
+ +Create the `config/aliases` file that the `alaveteli_request` exim `router` sources. This pipes mail from the special address to `script/mailin` and the `backupfoi` user. cat > /var/www/alaveteli/config/aliases <<'EOF' ^foi\\+.*: "|/var/www/alaveteli/script/mailin", backupfoi EOF -That's assuming that Alaveteli is running from `/var/www/alaveteli`. If it isn't, substitute the path it is running from. +_Note:_ Replace `/var/www/alaveteli` with the correct path to alaveteli if required. #### Set up your contact email recipient groups -- cgit v1.2.3 From fc11a8258c062d5e3e65ca3644c0610e57cde83a Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 12:25:57 +0100 Subject: Fix path typo --- docs/installing/email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 775e45ffa..56131a2d8 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -218,7 +218,7 @@ _Note:_ Replace `/var/www/alaveteli` with the correct path to alaveteli if requi #### Set up your contact email recipient groups -To set up recipient groups for the `team@` and `user-support@` email addresses at your domain, add alias records for them in `/var/www/alaveteli/config/etc/aliases` +To set up recipient groups for the `team@` and `user-support@` email addresses at your domain, add alias records for them in `/var/www/alaveteli/config/aliases` team: user@example.com, otheruser@example.com user-support: team -- cgit v1.2.3 From f5c7433963b86f54aaefc5051637ced2affa4ca2 Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 12:36:04 +0100 Subject: Create exim section for unwanted email --- docs/installing/email.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 56131a2d8..c5bfba130 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -223,14 +223,17 @@ To set up recipient groups for the `team@` and `user-support@` email addresses a team: user@example.com, otheruser@example.com user-support: team -You should also configure exim to discard any messages sent to the -[`BLACKHOLE_PREFIX`]({{ site.baseurl }}docs/customising/config/#blackhole_prefix) -address, whose default value is -`do-not-reply-to-this-address`. For example, add the following to -`config/aliases`: +#### Discard unwanted incoming email + +Configure exim to discard any messages sent to the [`BLACKHOLE_PREFIX`]({{ site.baseurl }}docs/customising/config/#blackhole_prefix) address, whose default value is `do-not-reply-to-this-address` - # We use this for envelope from for some messages where we don't care about delivery + cat >> /var/www/alaveteli/config/aliases < Date: Mon, 18 Aug 2014 12:41:56 +0100 Subject: Improve clarity of exim bounce handling --- docs/installing/email.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index c5bfba130..25ce73727 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -237,11 +237,22 @@ _Note:_ Replace `/var/www/alaveteli` with the correct path to alaveteli if requi #### Filter incoming messages to admin addresses -As described in ['Other mail']({{site.baseurl}}docs/installing/email#other-mail) you can make use of the script that filters mail to [`TRACK_SENDER_EMAIL`]({{site.baseurl}}docs/customising/config/#track_sender_email) and [`CONTACT_EMAIL`]({{site.baseurl}}docs/customising/config/#contact_email) for bounce messages before delivering it to your admin team. -To do this, for a `general.yml` file -that sets those addresses to `user-support@example.com` and -[`FORWARD_NONBOUNCE_RESPONSES_TO`]({{site.baseurl}}docs/customising/config/#forward_nonbounce_responses_to) to -`team@example.com`, update the `user-support` line in `/var/www/alaveteli/config/aliases`: +You can make use of Alaveteli's [automatic bounce handling]({{site.baseurl}}docs/installing/email/#automatic-bounce-handling-optional) to filter bounces sent to [`TRACK_SENDER_EMAIL`]({{site.baseurl}}docs/customising/config/#track_sender_email) +and [`CONTACT_EMAIL`]({{site.baseurl}}docs/customising/config/#contact_email). + +
+This guide assumes you have set the following in config/general.yml: + + + +Change the examples below to the addresses you have configured. +
+ +Change the `user-support` line in `/var/www/alaveteli/config/aliases`: user-support: |/var/www/alaveteli/script/handle-mail-replies -- cgit v1.2.3 From 12a5b1ec7b9e69d3d3313fcea491fc811646d360 Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 12:42:26 +0100 Subject: Fix typo --- docs/installing/email.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 25ce73727..0d66ba193 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -258,7 +258,7 @@ Change the `user-support` line in `/var/www/alaveteli/config/aliases`: #### Making the changes live in exim -Finally, execute the command: +Finally, execute the commands: update-exim4.conf service exim4 restart -- cgit v1.2.3 From b5a2e10d49e59a025900304868ca3922553c7936 Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 12:54:58 +0100 Subject: Bullet list 04_alaveteli_options MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Slightly easier to reference the variable you’re interested in compared to long-form writing Conflicts: --- docs/installing/email.md | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 0d66ba193..1cc7f9ec3 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -146,7 +146,13 @@ Create `/etc/exim4/conf.d/main/04_alaveteli_options` with the command: extract_addresses_remove_arguments=false EOF -This sets up `ALAVETELI_HOME` and `ALAVETELI_USER` for use in other config files, and sets up logging. The `ALAVETELI_HOME` variable should be set to the directory where Alaveteli is installed. `ALAVETELI_USER` should be the Unix user that is going to run your site. They should have write permissions on `ALAVETELI_HOME`. +This sets up `ALAVETELI_HOME` and `ALAVETELI_USER` for use in other config files, and sets up logging. + +- **`ALAVETELI_HOME`:** set to the directory where Alaveteli is installed. +- **`ALAVETELI_USER`:** should be the Unix user that is going to run your site. They should have write permissions on `ALAVETELI_HOME`. +- **`log_file_path`:** The name and location of the log files created by Exim must match what the `load-mail-server-logs` script expects +- **`MAIN_LOG_SELECTOR`:** The `check-recent-requests-sent` scripts expects the logs to contain the `from=<...>` envelope information, so we make the logs more verbose +- **`extract_addresses_remove_arguments`:** setting to `false` gets exim to treat the `-t` command line option that the `mail` gem uses when specifying delivery addresses on the command line as specifying that the addresses should be added, not removed. See [this `mail` issue](https://github.com/mikel/mail/issues/70) for more details.
Note: If you are editing an existing exim config rather than creating a new one, check the untrusted_set_sender option in /etc/exim4/conf.d/main/02_exim4-config_options. By default, untrusted users in exim are only allowed to set an empty envelope sender address, to declare that a message should never generate any bounces. untrusted_set_sender can be set to a list of address patterns, meaning that untrusted users are allowed to set envelope sender addresses that match any of the patterns in the list. If a pattern list is specified, you will need also to add ALAVETELI_USER to the MAIN_TRUSTED_USERS list in order to allow them to set the return path on outgoing mail. This option is also in /etc/exim4/conf.d/main/02_exim4-config_options in a split config. Look for the line that begins with MAIN_TRUSTED_USERS - something like: @@ -160,16 +166,6 @@ and add the alaveteli user: If untrusted_set_sender is set to *, that means that untrusted users can set envelope sender addresses without restriction, so there's no need to add ALAVETELI_USER to the MAIN_TRUSTED_USERS list.
-The name and location of the log files created by Exim must match what the -`load-mail-server-logs` script expects, which is why you must provide the -`log_file_path` setting. - -The `check-recent-requests-sent` scripts expects the logs to contain the -`from=<...>` envelope information, so we make the logs more verbose with -`MAIN_LOG_SELECTOR`. - -Setting `extract_addresses_remove_arguments` to `false` gets exim to treat the `-t` command line option that the `mail` gem uses when specifying delivery addresses on the command line as specifying that the addresses should be added, not removed. See [this `mail` issue](https://github.com/mikel/mail/issues/70) for more details. - #### Pipe incoming mail for requests from Exim to Alaveteli In this section, we'll add config to pipe incoming mail for special @@ -238,7 +234,7 @@ _Note:_ Replace `/var/www/alaveteli` with the correct path to alaveteli if requi #### Filter incoming messages to admin addresses You can make use of Alaveteli's [automatic bounce handling]({{site.baseurl}}docs/installing/email/#automatic-bounce-handling-optional) to filter bounces sent to [`TRACK_SENDER_EMAIL`]({{site.baseurl}}docs/customising/config/#track_sender_email) -and [`CONTACT_EMAIL`]({{site.baseurl}}docs/customising/config/#contact_email). +and [`CONTACT_EMAIL`]({{site.baseurl}}docs/customising/config/#contact_email).
This guide assumes you have set the following in config/general.yml: -- cgit v1.2.3 From cc220919d57a3fdf3cf4e878ed29b9ffdd293599 Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Mon, 18 Aug 2014 13:04:06 +0100 Subject: Less typing --- docs/installing/email.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 1cc7f9ec3..7c347414b 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -216,8 +216,10 @@ _Note:_ Replace `/var/www/alaveteli` with the correct path to alaveteli if requi To set up recipient groups for the `team@` and `user-support@` email addresses at your domain, add alias records for them in `/var/www/alaveteli/config/aliases` + cat >> /var/www/alaveteli/config/aliases < Date: Mon, 18 Aug 2014 13:11:06 +0100 Subject: Add section on exim logging --- docs/installing/email.md | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'docs/installing/email.md') diff --git a/docs/installing/email.md b/docs/installing/email.md index 7c347414b..c62f2fb53 100644 --- a/docs/installing/email.md +++ b/docs/installing/email.md @@ -254,6 +254,14 @@ Change the `user-support` line in `/var/www/alaveteli/config/aliases`: user-support: |/var/www/alaveteli/script/handle-mail-replies +#### Logging + +You’ll need to tell Alaveteli where the log files are stored and that they’re in exim format. Update [`MTA_LOG_PATH`]({{ site.baseurl }}docs/customising/config/#mta_log_path) and [`MTA_LOG_TYPE`]({{ site.baseurl }}docs/customising/config/#mta_log_type) in `config/general.yml`: + + MTA_LOG_PATH: '/var/log/exim4/exim-mainlog-*' + MTA_LOG_TYPE: 'exim' + + #### Making the changes live in exim Finally, execute the commands: -- cgit v1.2.3