Project

General

Profile

Set up local bounce processing » History » Version 8

Jon Goldberg, 02/03/2016 05:00 PM

1 1 Jon Goldberg
h1. Set up local bounce processing
2
3
If you're setting up CiviMail, you'll need a bounce processing account on a system that supports subaddressing.  "GMail/Google Apps works for this":http://wiki.civicrm.org/confluence/display/CRMDOC/Step-by-step+Return+Channel+on+Drupal+-+Google+Apps+-+CentOS - Exchange and Office 365 do not.  So it's often desirable to set up your own server for bounce processing - it takes very little overhead, so you can run it on the same VPS that runs CiviCRM.
4
5 8 Jon Goldberg
* Create a user account: @useradd -s /dev/null -m civibounces@.  Also set the password with @passwd@.
6 1 Jon Goldberg
* Install Postfix: @apt-get install postfix@.  Select all the standard options.
7
* Make sure your DNS A and PTR records are set up properly!  You should also have an MX record, though you can get away with not having it if the domain's A record points to the server.
8
* Install Dovecot.  In theory this is unnecessary - you can specify a mailbox on localhost - but I've had less trouble with this approach.  In Debian/Ubuntu: @apt-get install dovecot-imapd@.  You can skip SSL since it's all over localhost.
9 5 Joseph Lacey
* Create a user whose name will be the e-mail address.  E.g. for civi-bounces@mysite.org, @useradd -m civi-bounces -s /sbin/nologin@.  Add a password to the user account.
10
* For Debian, drop this file into /etc/dovecot/conf.d/99-mysettings.conf to configure dovecot.
11 1 Jon Goldberg
<pre>
12
protocols = imap
13
disable_plaintext_auth=no
14
mail_location = mbox:~/mail:INBOX=/var/spool/mail/%u
15
mail_privileged_group = mail
16 2 Jon Goldberg
</pre>
17 5 Joseph Lacey
** For CentOS this needs to be added to the mail /etc/dovecot/dovecot.conf file.  And "the permissions need to be changed per this":http://wiki2.dovecot.org/Errors/ChgrpNoPerm.
18 7 Jon Goldberg
* (Pretty sure this is NOT required on Debian 8, but maybe on other versions/distros): @chmod g+rw /var/spool/mail/*@
19 1 Jon Goldberg
* Check @/etc/postfix/main.cf@ to ensure that @mydestination@ includes the domain you want to deliver mail to (e.g. "mysite.org").
20 3 Jon Goldberg
* Open port 25 in your incoming firewall.
21 4 Joseph Lacey
** Linode has no firewall.
22
** Amazon EC2 can be configured in the AWS Console.
23
** Blackmesh managed servers have firewall that you need to submit a ticket to to open ports.
24 1 Jon Goldberg
* You should now be able to use this account for IMAP!  Punch a temporary hole in your firewall at port 143 to access it from outside and connect Thunderbird to the account.  Send a test message, of course.
25
* Configure the Bounce Processing account in CiviCRM as you would any other IMAP-based account.
Go to top