aboutsummaryrefslogtreecommitdiffstats
path: root/admin/www/mailman-install/customizing.html
blob: 4430a6c707f1d23c9f9b44527c97df2eda05d945 (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
<!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="node40.html" />
<link rel="prev" href="mail-server.html" />
<link rel="parent" href="front.html" />
<link rel="next" href="node40.html" />
<meta name='aesop' content='information' />
<title>7 Review your site defaults</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="6.4.3 More information"
  href="node38.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="8 Create a site-wide"
  href="node40.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="node38.html">6.4.3 More information</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="node40.html">8 Create a site-wide</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H1><A NAME="SECTION001700000000000000000"></A><A NAME="customizing"></A>
<BR>
7 Review your site defaults
</H1>

<P>
Mailman has a large number of site-wide configuration options which you should
now review and change according to your needs.  Some of the options control
how Mailman interacts with your environment, and other options select defaults
for newly created lists<A NAME="tex2html5"
  HREF="#foot728"><SUP>5</SUP></A>.
There are system tuning parameters and integration options.

<P>
The full set of site-wide defaults lives in the
<span class="file"><var>$prefix</var>/Mailman/Defaults.py</span> file, however you should
<strong>never</strong> modify this file!  Instead, change the <span class="file">mm_cfg.py</span> file in
that same directory.  You only need to add values to <span class="file">mm_cfg.py</span> that are
different than the defaults in <span class="file">Defaults.py</span>, and future Mailman upgrades
are guaranteed never to touch your <span class="file">mm_cfg.py</span> file.

<P>
The <span class="file">Defaults.py</span> file is documented extensively, so the options are not
described here.  The <span class="file">Defaults.py</span> and <span class="file">mm_cfg.py</span> are both
<a class="ulink" href="http://www.python.org"
  >Python</a> files so valid Python syntax must be
maintained or your Mailman installation will break.

<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>

<P>
You should make any changes to <span class="file">mm_cfg.py</span> using the account you
installed Mailman under in the <A href="troubleshooting.html#building">14</A> section.

<P>
<BR><HR><H4>Footnotes</H4>
<DL>
<DT><A NAME="foot728">... lists</A><A
 href="customizing.html#tex2html5"><SUP>5</SUP></A></DT>
<DD>In general, changing the list defaults
described in this section will not affect any already created lists.  To make
changes after a list has been created, use the web interface or the command
line scripts, such as <b class="program">bin/withlist</b> and <b class="program">bin/config_list</b>.

</DD>
</DL>
<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="6.4.3 More information"
  href="node38.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="8 Create a site-wide"
  href="node40.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="node38.html">6.4.3 More information</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="node40.html">8 Create a site-wide</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.1, documentation updated on December 13, 2005.</span>
</DIV>
<!--End of Navigation Panel-->

</BODY>
</HTML>