1 mlmmj for Debian
2 ----------------
4 INSTALLATION:
6 1) Configure a recipient delimiter. The default is to use '+'.
8 In postfix, add
9 recipient_delimiter = +
10 to /etc/postfix/main.cf
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.
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.
21 Also, see the MTA specific README files in /use/share/doc/mlmmj/ for more
22 details.
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.
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.
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.
37 mlmmj-test: | "/usr/bin/mlmmj-recieve -L /var/spool/mlmmj/mlmmj-test"
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.
45 The command to execute is:
47 chown -R <user> /var/spool/mlmmj/<listname>
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.
56 5) Look through /usr/share/doc/mlmmj/TUNABLES to check the options available
57 in mlmmj.
59 GENERAL NOTES:
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.
70 BUGS:
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.
79 -- Søren Boll Overgaard <boll@debian.org>, Tue, 31 Aug 2004 17:47:15 +0000