debian/README.Debian

   1 mlmmj for Debian
   2 ----------------
   3
   4 INSTALLATION:
   5
   6 1) Configure a recipient delimiter. The default is to use '+'.
   7
   8    In postfix, add
   9      recipient_delimiter = +
  10    to /etc/postfix/main.cf
  11
  12    In Exim, add
  13      local_part_suffix = +*
  14      local_part_suffix_optional
  15    to the "userforward:" and the "localuser:" router in /etc/exim/exim.conf.
  16
  17    If you are using another MTA, please refer to its manual or
  18      http://faqs.org/faqs/mail/addressing/
  19    which has some very useful information.
  20
  21    Also, see the MTA specific README files in /use/share/doc/mlmmj/ for more
  22    details.
  23
  24    This version of mlmmj supports setting the recipient delimiter on a
  25    per list basis. This is done by means of the TUNABLE "delimiter", described
  26    in detail in the TUNABLES document.
  27
  28 2) Run /usr/bin/mlmmj-make-ml which will guide you through creating the
  29    actual mailing list.
  30    Details about the exact operations of mlmmj-make-ml are available in
  31    /usr/share/doc/mlmmj/README.
  32
  33 3) If you didn't let mlmmj-make-ml modify /etc/aliases, you need to
  34    make the changes to your mailserver aliases that came as output from
  35    mlmmj-make-ml. Eg.
  36
  37    mlmmj-test:     | "/usr/bin/mlmmj-recieve -L /var/spool/mlmmj/mlmmj-test"
  38
  39 4) Mailing lists created by mlmmj-make-ml are owned by nobody:nogroup, unless
  40    the mlmmj-make-ml script is able to determine which MTA is handling your
  41    lists. If that is the case, it will set permissions accordingly, and check
  42    if any of your existing lists have seemingly wrong ownership.
  43    If default ownership is applied, you will need to tweak ownerships yourself.
  44
  45    The command to execute is:
  46
  47    chown -R <user> /var/spool/mlmmj/<listname>
  48
  49    where <user> is the user that applies to your MTA, and <listname> is the
  50    name of the list you just created.
  51    If you would like your MTA added to the list of automatically detected ones,
  52    please submit a bug against mlmmj in the Debian BTS (http://bugs.debian.org)
  53    and include the user/group information needed to make mlmmj work with your
  54    MTA.
  55
  56 5) Look through /usr/share/doc/mlmmj/TUNABLES to check the options available
  57    in mlmmj.
  58
  59 GENERAL NOTES:
  60
  61 * In order to comply with the FHS, the control and text subdirectories of each
  62   list, are created in /etc/mlmmj/lists/<listname> instead of under
  63   /var/spool/mlmmj/<listname>. Symlinks are created to keep functionality
  64   intact, so you should have no problems editing the files via their links
  65   under /var
  66 * Additionally, the files README and README.access in /use/share/doc/mlmmj/
  67   include information about access control, moderation, archiving and lots of
  68   other features supported by mlmmj. You would do well to read them.
  69
  70 BUGS:
  71
  72 * The list-subscribers feature was added in mlmmj 1.2.5 and a new list text
  73   file was introduced accordingly. This file, called "listsubs" was not
  74   installed by the mlmmj-make-ml script before 1.2.5-1 and as such the list
  75   subscribers feature probably won't work in pre 1.2.5 lists, unless you
  76   copy /usr/share/mlmmj/text.skel/listsubs into
  77   /etc/mlmmj/lists/<listname>/text in all your pre 1.2.5 lists.
  78
  79  -- Søren Boll Overgaard <boll@debian.org>, Tue, 31 Aug 2004 17:47:15 +0000