aboutsummaryrefslogtreecommitdiffstats
path: root/docs/installing/email.md
diff options
context:
space:
mode:
authorLouise Crow <louise.crow@gmail.com>2014-08-18 16:29:24 +0100
committerLouise Crow <louise.crow@gmail.com>2014-08-18 16:29:24 +0100
commit9aafc0daf0da4e1dd56f721398c1318deb421d18 (patch)
treea507e6c4a8ba3a915401756f0ef064b62657bca0 /docs/installing/email.md
parent53806f8341275991e966efb55ed6d727552f0620 (diff)
Use attention box for existing config note.
Diffstat (limited to 'docs/installing/email.md')
-rw-r--r--docs/installing/email.md12
1 files changed, 11 insertions, 1 deletions
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.
+<div class="attention-box">
+Note: If you are editing an existing exim config rather than creating a new one, check the <code>untrusted_set_sender</code> option in <code>/etc/exim4/conf.d/main/02_exim4-config_options</code>. 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. <code>untrusted_set_sender</code> 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 <code>ALAVETELI_USER</code> to the <code>MAIN_TRUSTED_USERS</code> list in order to allow them to set the return path on outgoing mail. This option is also in <code>/etc/exim4/conf.d/main/02_exim4-config_options</code> in a split config. Look for the line that begins with <code>MAIN_TRUSTED_USERS</code> - something like:
+
+ <pre><code>MAIN_TRUSTED_USERS = uucp</code></pre>
+
+and add the alaveteli user:
+
+ <pre><code>MAIN_TRUSTED_USERS = uucp : alaveteli</code></pre>
+
+ If <code>untrusted_set_sender</code> is set to <code>*</code>, that means that untrusted users can set envelope sender addresses without restriction, so there's no need to add <code>ALAVETELI_USER</code> to the <code>MAIN_TRUSTED_USERS</code> list.
+</div>
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