Schleuder for Debian
====================

Setting up Schleuder
--------------------

1. Edit /etc/schleuder/schleuder.conf to suit the site configuration.

   Most defaults should be fine with most setups but you might want to adjust
   `superadminaddr`.

2. Create a new mailing list using schleuder-newlist(8).

   e.g. # schleuder-newlist list@example.org

3. Adjust list settings in /etc/schleuder/lists/DOMAIN/LISTNAME.conf

   More information on the various settings can be found in
   /etc/schleuder/default-list.conf.

4. Setup the MTA to pipe messages to Schleuder addresses

   See below for how it can be done with Exim 4 and Postfix.

5. Send an email to list-sendkey@example.org. If everything goes fine, you
   should get a reply containing the list public key. If it does not, check
   the various log files for any clues.

6. Add more members!  The easiest way is to send an encrypted email to
   `list-request@example.org` having in the body:

     X-ADD-MEMBER: new.member@example.org mime
     -----BEGIN PGP PUBLIC KEY BLOCK-----
     Version: GnuPG v1.4.9 (GNU/Linux)

     mQGiBEjVO7oRBADQvT6wtD2IzzIiK0NbrcilCKCp4MWb8cYXTXguwPQI6y0Nerz4
     dsK6J0X1Vgeo02tqA4xd3EDK8rdqL2yZfl/2egH8+85R3gDk+kqkfEp4pwCgp6VO
     [...]
     pNlF/qkaWwRb048h+iMrW21EkouLKTDPFkdFbapV2X5KJZIcfhO1zEbwc1ZKF3Ju
     =xTv3
     -----END PGP PUBLIC KEY BLOCK-----

     Replace the KEY BLOCK with an ascii export of the new member's public key.

7. Enjoy!

Using Schleuder with Exim 4
---------------------------

The file names presented here assume that you have opted for the split
Exim configuration.

In /etc/exim4/conf.d/router/550_schleuder, write:

  schleuder:
     debug_print = "R: schleuder for ${recipient}"
     driver = accept
     local_part_suffix_optional
     local_part_suffix = +* : -bounce : -sendkey : -request : -owner
     domains = +local_domains
     require_files = schleuder:/var/lib/schleuder/${domain}/${local_part}/
     transport = schleuder_transport

Then, in /etc/exim4/conf.d/transport/30_schleuder, write:

  schleuder_transport:
      debug_print = "T: schleuder_transport for ${recipient}"
      driver = pipe
      user = schleuder
      group = schleuder
      home_directory = "/var/lib/schleuder/${domain}/${local_part}"
      command = "/usr/bin/schleuder ${recipient}"

Finally, regenerate a full configuration file:

  # update-exim4.conf

New lists created in `/var/lib/schleuder` (default when using
schleuder-newlist(8)) will automatically work when using this setup.

For another advanced Exim setup, using an SQL database and multiple Unix
accounts, please have a look at:

  http://schleuder.nadir.org/documentation/configurationeximplus.html

Using Schleuder with Postfix
----------------------------

The proposed setup for Postfix is to use a dedicated "schleuder"
transport.  List addresses will be manually directed to use this
specific transport using `transport_maps`, see transport(5) for
details.

1. In `/etc/postfix/master.cf`, add:

     schleuder  unix  -       n       n       -       -       pipe
       flags=DRhu user=schleuder argv=/usr/bin/schleuder ${recipient}

2. Then, in `/etc/postfix/main.cf`, add:

     schleuder_destination_recipient_limit = 1
     transport_maps = hash:/etc/postfix/transports

3. a. If you want to have mailing lists managed by Schleuder with other
      addresses under the same domain you must list every mailing list
      in `/etc/postfix/transports`, like the following:

        LISTNAME@host.tld          schleuder:
        LISTNAME-bounces@host.tld  schleuder:
        LISTNAME-sendkey@host.tld  schleuder:
        LISTNAME-request@host.tld  schleuder:
        LISTNAME-owner@host.tld    schleuder:

   b. Or, if you dedicate a specific domain-name to Schleuder lists,
      simply add the following line to `/etc/postfix/transports`:

        host.tld   schleuder:

4. Refresh the transport map by doing:

     # postmap /etc/postfix/transports

Other Schleuder setups
----------------------

If you manage to get a nice working setup with your favorite MTA, please
send an email to `schleuder2@nadir.org`, add it to Schleuder wiki or
submit a wishlist bug against the `schleuder` package in debian.

Using `/etc/aliases` and `sudo` might be the best fallback if you can't figure
it out.

Logging
-------

To respect Debian policy, Schleuder has been modified to keep list logs
by default under `/var/log/schleuder/<LISTNAME>.log`.

Logging can also be done using syslog(3) (under the `mail` facility) by
specifying "syslog" for the `lists_logfile` and `logfile` parameters in
`/etc/schleuder/schleuder.conf`.

schleuder account
-----------------

The Debian package for Schleuder creates a "schleuder" account on
installation.  The list creation program, schleuder-newlist(8), will
default to use this account when creating new lists.  If you wish to
have schleuder(8) running with other account credentials, you will need
to make those users members of the "schleuder" group to allow them to
write to `/var/log/schleuder`.

WebSchleuder
------------

The web management interface for Schleuder has not yet been packaged for
Debian.  Any help is highly welcome.

 -- Jérémy Bobbio <lunar@debian.org>  Sat, 29 Aug 2009 23:21:23 +0200