aboutsummaryrefslogtreecommitdiffstats
path: root/admin/www/mailman-install/customizing.html
blob: a8a39d7965fcb119ac2e044e53a6343a252c1628 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="mailman-install.css" type='text/css' />
<link rel="first" href="mailman-install.html" title='GNU Mailman - Installation Manual' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="node44.html" />
<link rel="prev" href="node42.html" />
<link rel="parent" href="front.html" />
<link rel="next" href="node44.html" />
<meta name='aesop' content='information' />
<title>11 Customize Mailman</title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="10 Check the hostname"
  href="node42.html"><img src='previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="Front Matter"
  href="front.html"><img src='up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="12 Create your first"
  href="node44.html"><img src='next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">GNU Mailman - Installation Manual</td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node42.html">10 Check the hostname</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="front.html">Front Matter</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node44.html">12 Create your first</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H1><A NAME="SECTION0011100000000000000000"></A><A NAME="customizing"></A>
<BR>
11 Customize Mailman
</H1>

<P>
Now that Mailman is all set up, there are a few site-wide configurations you
can make before you start creating mailing lists.  You should do these steps
using the account you installed Mailman under in the <A href="troubleshooting.html#building">13</A> section.

<P>

<UL>
<LI>The file <span class="file"><var>$prefix/Mailman/Defaults.py</var></span> contains a number of
      defaults for your installation.  If any of these are incorrect, override
      them in <span class="file"><var>$prefix</var>/Mailman/mm_cfg.py</span>, <strong>not</strong> in the
      <span class="file">Defaults.py</span> file!  See the comments in <span class="file">Defaults.py</span> for
      details.  Once a list is created, editing many of these variables will
      have no effect.  At that point, you'll need to configure your lists
      through the web administration interface or through the command line
      scripts <b class="program">bin/withlist</b> and <b class="program">bin/config_list</b>.

<P>
The install process will never overwrite an existing <span class="file">mm_cfg.py</span>
      file so you can freely make changes to this file.

<P>
<div class="note"><b class="label">Note:</b>

      Do <strong>not</strong> change the <var>HOME_DIR</var> or <var>MAILMAN_DIR</var>
      variables.  These are set automatically by the <b class="program">configure</b>
      script, and you will break your Mailman installation by if you change
      these.
      </div>
</LI>
<LI>Create the site password.  Use this command:

<P>
<div class="verbatim"><pre>
    % $prefix/bin/mmsitepass &lt;your-site-password&gt;
</pre></div>

<P>
This password can be used anywhere that individual user or mailing list
    administrator passwords are required, giving the mailman site
    administrator the ability to adjust these things when necessary.

<P>
You may also want to create a password for the site-wide ``list creator''
    role.  The list creator is someone other than the site administrator who
    has privileges to create and remove lists through the web interface.  Use
    the <b class="programopt">-c</b> option to <b class="program">mmsitepass</b> to set this.

<P>
</LI>
</UL>

<P>

<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="10 Check the hostname"
  href="node42.html"><img src='previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="Front Matter"
  href="front.html"><img src='up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="12 Create your first"
  href="node44.html"><img src='next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">GNU Mailman - Installation Manual</td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
<td class='online-navigation'><img src='blank.png'
  border='0' height='32'  alt='' width='32' /></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node42.html">10 Check the hostname</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="front.html">Front Matter</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node44.html">12 Create your first</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.1, documentation updated on December 13, 2004.</span>
</DIV>
<!--End of Navigation Panel-->

</BODY>
</HTML>