Add Debian directory
[mspang/vmailman.git] / debian / README.Debian
1 Notes for the debian mailman package.
2 =====================================
3
4
5 Getting started
6 ---------------
7
8 You can access the web interface of mailman on
9 http://<hostname>/cgi-bin/mailman/listinfo
10
11 You can create new lists with the newlist command (you have to add the
12 aliases it needs by hand to /etc/aliases or the corresponding database
13 because mailman can not know about configuration of all MTA's, but newlist 
14 tells you about the alias it needs, but see the notes on qmail and postfix
15 below).
16
17 For users of exim: if you want to use the /etc/aliases file for mailman
18 aliases, you'll need to specify a user=list line or something like that in
19 the system_aliases director.
20
21 As of 2.0.6-1, gate-news is commented out in the default crontab,
22 since most people will be less interested in gating news-to-mail and
23 vice versa.  This is asked by a low priority debconf question, so you
24 can change it through debconf or by editing the crontab by hand.
25
26 As of 2.1.4-2 a debconf question has been added allowing for
27 installing only templates for languages used at your site in
28 /etc/mailman (mailman/site_languages).
29
30 An example Apache configuration is included in /etc/mailman/apache.conf.
31 It can be copied to or symlinked from e.g. the /etc/apache2/conf.d/ directory.
32
33 Apache + suexec
34 ---------------
35
36 Since suexec forbids execution of CGIs with gid < 50 and www-data (the default
37 for mailman cgi) is 33, you should execute the cgi with a gid of 50-99 or 65534.
38 It cannot be any other gid since mailman cgi check that gid < 100 or == 65534.
39
40 Qmail
41 -----
42 For those using qmail, please see the comments in
43 /etc/mailman/qmail-to-mailman.py and set it up according to those
44 instructions. Additional information may be available in
45 /usr/share/doc/mailman/README.QMAIL.gz
46
47 Postfix
48 _______
49 For those using postfix who are able to devote a full subdomain
50 lists.example.com for use by Mailman, please see the comments in
51 /etc/mailman/postfix-to-mailman.py .
52
53 SpamAssassin
54 ------------
55 As of Mailman 2.1-1, Mailman includes the SpamAssassin patch from
56 Sourceforge.net.  It is not enabled by default.  If you want to enable
57 the handler, adding
58
59 GLOBAL_PIPELINE.insert(1, 'SpamAssassin')
60
61 at the bottom of your mm_cfg.py should enable it. You can read more
62 documentation about how to configure SpamAssassin and Mailman together at
63 http://www.daa.com.au/~james/articles/mailman-spamassassin/
64 The current version of this handler used in this package is released on
65 2003 May 6 by James Henstridge <james@daa.com.au>.
66
67 Upgrading from Mailman 2.x (where x < 1)
68 ----------------------------------------
69
70 Mailman 2.1 has some new aliases which you might want to add, namely
71 admin, bounces, confirm, join, leave, owner, request, subscribe and
72 unsubscribe.
73
74 Also, /var/lib/mailman/mail/wrapper was changed to
75 /var/lib/mailman/mail/mailman.  A compatilbility symlink has been
76 added, but it will be removed in some future version, so please update
77 your alias files.
78
79 You must create a "mailman" list on your system, until it is added,
80 mailman will not start.  (It will yell at you, so you should notice.)
81
82 List admin and moderator passwords will be broken. Use
83 /var/lib/mailman/bin/change_pw to generate new ones and email them to
84 the admins and moderators.
85
86  -- Lionel Elie Mamane <lmamane@debian.org>, dim, 27 aoĆ» 2006 19:08:42 +0200