Ignore:
Timestamp:
May 23, 2012, 6:32:54 PM (13 years ago)
Author:
Borja Lopez <borja@…>
Branch:
default
Phase:
public
Message:

Added more information to the README file

Updated the architecture scheme so it fits the renaming of the project
to mailjam

Fixed the search path for configuration files. Now it searches on /etc
first, /usr/local/etc then.

Added more docs regarding the installation, configuration and running
of each component

File:
1 edited

Legend:

Unmodified
Added
Removed

  • docs/src/_build/html/configuration.html

    r16 r27  
    5353           
    5454  <div class="section" id="configuration">
    55 <h1><a class="toc-backref" href="#id9">Configuration</a><a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h1>
     55<h1><a class="toc-backref" href="#id28">Configuration</a><a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h1>
     56<p>Mailjam has separate configuration files for the different apps (the daemon and
     57the variety of different clients available). Check below to read more about the
     58configuration file you need to modify depending on what you want to do.</p>
    5659<div class="contents topic" id="contents">
    5760<p class="topic-title first">Contents</p>
    5861<ul class="simple">
    59 <li><a class="reference internal" href="#configuration" id="id9">Configuration</a><ul>
    60 <li><a class="reference internal" href="#mailjam-daemon-configuration-file" id="id10">Mailjam daemon configuration file</a><ul>
    61 <li><a class="reference internal" href="#xmlrpc-server" id="id11">xmlrpc_server</a><ul>
    62 <li><a class="reference internal" href="#address" id="id12">address</a></li>
    63 <li><a class="reference internal" href="#port" id="id13">port</a></li>
    64 <li><a class="reference internal" href="#ssl" id="id14">ssl</a></li>
    65 <li><a class="reference internal" href="#ssl-key" id="id15">ssl_key</a></li>
    66 <li><a class="reference internal" href="#ssl-crt" id="id16">ssl_crt</a></li>
    67 <li><a class="reference internal" href="#logfile" id="id17">logfile</a></li>
    68 </ul>
    69 </li>
    70 <li><a class="reference internal" href="#storage" id="id18">storage</a><ul>
    71 <li><a class="reference internal" href="#backend" id="id19">backend</a></li>
    72 <li><a class="reference internal" href="#path" id="id20">path</a></li>
    73 <li><a class="reference internal" href="#lists-db" id="id21">lists_db</a></li>
    74 <li><a class="reference internal" href="#members-db" id="id22">members_db</a></li>
    75 </ul>
    76 </li>
    77 <li><a class="reference internal" href="#archive" id="id23">archive</a><ul>
    78 <li><a class="reference internal" href="#enabled" id="id24">enabled</a></li>
    79 <li><a class="reference internal" href="#configuration-daemon-archive-backend" id="id25">backend</a></li>
    80 <li><a class="reference internal" href="#configuration-daemon-archive-path" id="id26">path</a></li>
    81 </ul>
    82 </li>
    83 <li><a class="reference internal" href="#mailing-lists" id="id27">mailing_lists</a><ul>
    84 <li><a class="reference internal" href="#private" id="id28">private</a></li>
    85 </ul>
    86 </li>
    87 <li><a class="reference internal" href="#members" id="id29">members</a><ul>
    88 <li><a class="reference internal" href="#auto-signup" id="id30">auto_signup</a></li>
    89 <li><a class="reference internal" href="#allow-chpasswd" id="id31">allow_chpasswd</a></li>
    90 </ul>
    91 </li>
    92 </ul>
    93 </li>
    94 </ul>
    95 </li>
    96 </ul>
    97 </div>
    98 <div class="section" id="mailjam-daemon-configuration-file">
    99 <span id="configuration-daemon"></span><h2><a class="toc-backref" href="#id10">Mailjam daemon configuration file</a><a class="headerlink" href="#mailjam-daemon-configuration-file" title="Permalink to this headline">¶</a></h2>
    100 <p>All the configurations that can be applied to the Mailjam daemon are registered
    101 in the <strong>mailjam.conf</strong> file. That file contains ini-style <a class="footnote-reference" href="#id6" id="id1">[1]</a> configuration
    102 parameters, separated in different <em>categories</em>.</p>
     62<li><a class="reference internal" href="#configuration" id="id28">Configuration</a><ul>
     63<li><a class="reference internal" href="#mailjam-daemon-configuration-file-mailjam-conf" id="id29">Mailjam daemon configuration file - mailjam.conf</a><ul>
     64<li><a class="reference internal" href="#xmlrpc-server" id="id30">xmlrpc_server</a><ul>
     65<li><a class="reference internal" href="#address" id="id31">address</a></li>
     66<li><a class="reference internal" href="#port" id="id32">port</a></li>
     67<li><a class="reference internal" href="#ssl" id="id33">ssl</a></li>
     68<li><a class="reference internal" href="#ssl-key" id="id34">ssl_key</a></li>
     69<li><a class="reference internal" href="#ssl-crt" id="id35">ssl_crt</a></li>
     70<li><a class="reference internal" href="#logfile" id="id36">logfile</a></li>
     71</ul>
     72</li>
     73<li><a class="reference internal" href="#storage" id="id37">storage</a><ul>
     74<li><a class="reference internal" href="#backend" id="id38">backend</a></li>
     75<li><a class="reference internal" href="#path" id="id39">path</a></li>
     76<li><a class="reference internal" href="#lists-db" id="id40">lists_db</a></li>
     77<li><a class="reference internal" href="#members-db" id="id41">members_db</a></li>
     78</ul>
     79</li>
     80<li><a class="reference internal" href="#archive" id="id42">archive</a><ul>
     81<li><a class="reference internal" href="#enabled" id="id43">enabled</a></li>
     82<li><a class="reference internal" href="#configuration-daemon-archive-backend" id="id44">backend</a></li>
     83<li><a class="reference internal" href="#configuration-daemon-archive-path" id="id45">path</a></li>
     84</ul>
     85</li>
     86<li><a class="reference internal" href="#mailing-lists" id="id46">mailing_lists</a><ul>
     87<li><a class="reference internal" href="#private" id="id47">private</a></li>
     88</ul>
     89</li>
     90<li><a class="reference internal" href="#members" id="id48">members</a><ul>
     91<li><a class="reference internal" href="#auto-signup" id="id49">auto_signup</a></li>
     92<li><a class="reference internal" href="#allow-chpasswd" id="id50">allow_chpasswd</a></li>
     93</ul>
     94</li>
     95</ul>
     96</li>
     97<li><a class="reference internal" href="#mailjam-mta-client-configuration-file-mailjam-mta-conf" id="id51">Mailjam MTA client configuration file - mailjam-mta.conf</a><ul>
     98<li><a class="reference internal" href="#server" id="id52">server</a><ul>
     99<li><a class="reference internal" href="#configuration-mta-client-server-address" id="id53">address</a></li>
     100<li><a class="reference internal" href="#configuration-mta-client-server-port" id="id54">port</a></li>
     101<li><a class="reference internal" href="#uri" id="id55">uri</a></li>
     102<li><a class="reference internal" href="#configuration-mta-client-server-ssl" id="id56">ssl</a></li>
     103</ul>
     104</li>
     105<li><a class="reference internal" href="#configuration-mta-client-archive" id="id57">archive</a><ul>
     106<li><a class="reference internal" href="#persistent" id="id58">persistent</a></li>
     107<li><a class="reference internal" href="#configuration-mta-client-archive-path" id="id59">path</a></li>
     108</ul>
     109</li>
     110</ul>
     111</li>
     112<li><a class="reference internal" href="#mailjam-cli-client-configuration-file-mailjam-cli-conf" id="id60">Mailjam CLI client configuration file - mailjam-cli.conf</a><ul>
     113<li><a class="reference internal" href="#configuration-cli-client-server" id="id61">server</a><ul>
     114<li><a class="reference internal" href="#configuration-cli-client-server-address" id="id62">address</a></li>
     115<li><a class="reference internal" href="#configuration-cli-client-server-port" id="id63">port</a></li>
     116<li><a class="reference internal" href="#configuration-cli-client-server-uri" id="id64">uri</a></li>
     117<li><a class="reference internal" href="#configuration-cli-client-server-ssl" id="id65">ssl</a></li>
     118</ul>
     119</li>
     120<li><a class="reference internal" href="#history" id="id66">history</a><ul>
     121<li><a class="reference internal" href="#configurtion-cli-client-archive-enabled" id="id67">enabled</a></li>
     122<li><a class="reference internal" href="#configuration-cli-client-history-path" id="id68">path</a></li>
     123</ul>
     124</li>
     125</ul>
     126</li>
     127</ul>
     128</li>
     129</ul>
     130</div>
     131<div class="section" id="mailjam-daemon-configuration-file-mailjam-conf">
     132<span id="configuration-daemon"></span><h2><a class="toc-backref" href="#id29">Mailjam daemon configuration file - mailjam.conf</a><a class="headerlink" href="#mailjam-daemon-configuration-file-mailjam-conf" title="Permalink to this headline">¶</a></h2>
     133<p>All the configurations that can be applied to the <a class="reference internal" href="overview.html#overview-mailjam-daemon"><em>Mailjam daemon</em></a>
     134are registered in the <strong>mailjam.conf</strong> file. That file contains ini-style <a class="footnote-reference" href="#id24" id="id1">[1]</a>
     135configuration parameters, separated in different <em>categories</em>.</p>
    103136<div class="admonition note">
    104137<p class="first admonition-title">Note</p>
    … …  
    106139your setup. The usual locations are:</p>
    107140<ul class="simple">
    108 <li><em>/etc/mailjam.conf</em> - In most Linux systems (like archlinux, gentoo,
    109 fedora, debian, ubuntu, etc)</li>
    110 <li><em>/usr/local/etc/mailjam.conf</em> - In most BSD systems (like FreeBSD, OpenBSD,
    111 NetBSD, etc)</li>
     141<li><em>/etc/mailjam/mailjam.conf</em> - In most Linux systems (like archlinux,
     142gentoo, fedora, debian, ubuntu, etc)</li>
     143<li><em>/usr/local/etc/mailjam/mailjam.conf</em> - In most BSD systems (like FreeBSD,
     144OpenBSD, NetBSD, etc)</li>
    112145</ul>
    113146<p class="last">There is a copy of the configuration file in the <em>conf/</em> directory, within
    … …  
    115148</div>
    116149<div class="section" id="xmlrpc-server">
    117 <span id="configuration-daemon-xmlrpc"></span><h3><a class="toc-backref" href="#id11">xmlrpc_server</a><a class="headerlink" href="#xmlrpc-server" title="Permalink to this headline">¶</a></h3>
     150<span id="configuration-daemon-xmlrpc"></span><h3><a class="toc-backref" href="#id30">xmlrpc_server</a><a class="headerlink" href="#xmlrpc-server" title="Permalink to this headline">¶</a></h3>
    118151<p>This section contains the configuration parameters that modify the behaviour of
    119 the daemon when serving content through XMLRPC <a class="footnote-reference" href="#id7" id="id2">[2]</a>.</p>
     152the daemon when serving content through XMLRPC <a class="footnote-reference" href="#id25" id="id2">[2]</a>.</p>
    120153<p>These are all the available parameters in this section:</p>
    121154<div class="section" id="address">
    122 <span id="configuration-daemon-xmlrpc-address"></span><h4><a class="toc-backref" href="#id12">address</a><a class="headerlink" href="#address" title="Permalink to this headline">¶</a></h4>
     155<span id="configuration-daemon-xmlrpc-address"></span><h4><a class="toc-backref" href="#id31">address</a><a class="headerlink" href="#address" title="Permalink to this headline">¶</a></h4>
    123156<p>Default: <tt class="docutils literal"><span class="pre">localhost</span></tt></p>
    124157<p>The address where the daemon will be listening for XMLRPC requests. Use <tt class="docutils literal"><span class="pre">*</span></tt>
    … …  
    127160</div>
    128161<div class="section" id="port">
    129 <span id="configuration-daemon-xmlrpc-port"></span><h4><a class="toc-backref" href="#id13">port</a><a class="headerlink" href="#port" title="Permalink to this headline">¶</a></h4>
     162<span id="configuration-daemon-xmlrpc-port"></span><h4><a class="toc-backref" href="#id32">port</a><a class="headerlink" href="#port" title="Permalink to this headline">¶</a></h4>
    130163<p>Default: <tt class="docutils literal"><span class="pre">9876</span></tt></p>
    131164<p>The port where the daemon will be listening por XMLRPC requests.</p>
    132165</div>
    133166<div class="section" id="ssl">
    134 <span id="configuration-daemon-xmlrpc-ssl"></span><h4><a class="toc-backref" href="#id14">ssl</a><a class="headerlink" href="#ssl" title="Permalink to this headline">¶</a></h4>
    135 <p>Default: <tt class="docutils literal"><span class="pre">off</span></tt> (because ssl support hasn&#8217;t been added yet)</p>
    136 <p>Enables/disables SSL <a class="footnote-reference" href="#id8" id="id3">[3]</a> support in the daemon. If <tt class="docutils literal"><span class="pre">off</span></tt> all the traffic
    137 to/from the server will travel unencrypted. If <tt class="docutils literal"><span class="pre">on</span></tt> all the traffic will
     167<span id="configuration-daemon-xmlrpc-ssl"></span><h4><a class="toc-backref" href="#id33">ssl</a><a class="headerlink" href="#ssl" title="Permalink to this headline">¶</a></h4>
     168<p>Default: <tt class="docutils literal"><span class="pre">false</span></tt> (because ssl support hasn&#8217;t been added yet)</p>
     169<p>Enables/disables SSL <a class="footnote-reference" href="#id26" id="id3">[3]</a> support in the daemon. If <tt class="docutils literal"><span class="pre">false</span></tt> all the traffic
     170to/from the server will travel unencrypted. If <tt class="docutils literal"><span class="pre">true</span></tt> all the traffic will
    138171travel encrypted.</p>
    139172</div>
    140173<div class="section" id="ssl-key">
    141 <span id="configuration-daemon-xmlrpc-ssl-key"></span><h4><a class="toc-backref" href="#id15">ssl_key</a><a class="headerlink" href="#ssl-key" title="Permalink to this headline">¶</a></h4>
     174<span id="configuration-daemon-xmlrpc-ssl-key"></span><h4><a class="toc-backref" href="#id34">ssl_key</a><a class="headerlink" href="#ssl-key" title="Permalink to this headline">¶</a></h4>
    142175<p>Default: <tt class="docutils literal"><span class="pre">/usr/local/etc/mailjam/ssl/mailjam.key</span></tt></p>
    143176<p>Path to the ssl key used for encrypted SSL sessions.</p>
    … …  
    148181</div>
    149182<div class="section" id="ssl-crt">
    150 <span id="configuration-daemon-xmlrpc-ssl-crt"></span><h4><a class="toc-backref" href="#id16">ssl_crt</a><a class="headerlink" href="#ssl-crt" title="Permalink to this headline">¶</a></h4>
     183<span id="configuration-daemon-xmlrpc-ssl-crt"></span><h4><a class="toc-backref" href="#id35">ssl_crt</a><a class="headerlink" href="#ssl-crt" title="Permalink to this headline">¶</a></h4>
    151184<p>Default: <tt class="docutils literal"><span class="pre">/usr/local/etc/mailjam/ssl/mailjam.crt</span></tt></p>
    152185<p>Path to the ssl certificate used for encrypted SSL sessions.</p>
    … …  
    157190</div>
    158191<div class="section" id="logfile">
    159 <span id="configuration-daemon-xmlrpc-logfile"></span><h4><a class="toc-backref" href="#id17">logfile</a><a class="headerlink" href="#logfile" title="Permalink to this headline">¶</a></h4>
     192<span id="configuration-daemon-xmlrpc-logfile"></span><h4><a class="toc-backref" href="#id36">logfile</a><a class="headerlink" href="#logfile" title="Permalink to this headline">¶</a></h4>
    160193<p>Default: <tt class="docutils literal"><span class="pre">/var/log/mailjam/xmlrpc_server.log</span></tt></p>
    161194<p>Path to the file where log messages will be saved</p>
    … …  
    163196</div>
    164197<div class="section" id="storage">
    165 <span id="configuration-daemon-storage"></span><h3><a class="toc-backref" href="#id18">storage</a><a class="headerlink" href="#storage" title="Permalink to this headline">¶</a></h3>
     198<span id="configuration-daemon-storage"></span><h3><a class="toc-backref" href="#id37">storage</a><a class="headerlink" href="#storage" title="Permalink to this headline">¶</a></h3>
    166199<p>This section contains the configuration parameters that modify the way the
    167200daemon saves data to disk, using one of the storage backends.</p>
    168201<p>These are all the available parameters in this section:</p>
    169202<div class="section" id="backend">
    170 <span id="configuration-daemon-storage-backend"></span><h4><a class="toc-backref" href="#id19">backend</a><a class="headerlink" href="#backend" title="Permalink to this headline">¶</a></h4>
     203<span id="configuration-daemon-storage-backend"></span><h4><a class="toc-backref" href="#id38">backend</a><a class="headerlink" href="#backend" title="Permalink to this headline">¶</a></h4>
    171204<p>Default: <tt class="docutils literal"><span class="pre">json</span></tt></p>
    172205<p>Sets the type of backend the daemon is going to use. Right now the only backend
    … …  
    174207</div>
    175208<div class="section" id="path">
    176 <span id="configuration-daemon-xmlrpc-path"></span><h4><a class="toc-backref" href="#id20">path</a><a class="headerlink" href="#path" title="Permalink to this headline">¶</a></h4>
     209<span id="configuration-daemon-xmlrpc-path"></span><h4><a class="toc-backref" href="#id39">path</a><a class="headerlink" href="#path" title="Permalink to this headline">¶</a></h4>
    177210<p>Default: <tt class="docutils literal"><span class="pre">/usr/local/mailjam/storage</span></tt></p>
    178211<p>Path to the directory where the backend will save data.</p>
    179212</div>
    180213<div class="section" id="lists-db">
    181 <span id="configuration-daemon-storage-lists-db"></span><h4><a class="toc-backref" href="#id21">lists_db</a><a class="headerlink" href="#lists-db" title="Permalink to this headline">¶</a></h4>
     214<span id="configuration-daemon-storage-lists-db"></span><h4><a class="toc-backref" href="#id40">lists_db</a><a class="headerlink" href="#lists-db" title="Permalink to this headline">¶</a></h4>
    182215<p>Default: <tt class="docutils literal"><span class="pre">/usr/local/mailjam/storage/mailings.json</span></tt></p>
    183216<p>Path to the file where the identifiers of existing mailing lists will be saved.</p>
    … …  
    200233</div>
    201234<div class="section" id="members-db">
    202 <span id="configuration-daemon-xmlrpc-members-db"></span><h4><a class="toc-backref" href="#id22">members_db</a><a class="headerlink" href="#members-db" title="Permalink to this headline">¶</a></h4>
     235<span id="configuration-daemon-xmlrpc-members-db"></span><h4><a class="toc-backref" href="#id41">members_db</a><a class="headerlink" href="#members-db" title="Permalink to this headline">¶</a></h4>
    203236<p>Default: <tt class="docutils literal"><span class="pre">/usr/local/mailjam/storage/members.json</span></tt></p>
    204237<p>Path to the file where the identifiers of existing members will be saved.</p>
    … …  
    211244</div>
    212245<div class="section" id="archive">
    213 <span id="configuration-daemon-archive"></span><h3><a class="toc-backref" href="#id23">archive</a><a class="headerlink" href="#archive" title="Permalink to this headline">¶</a></h3>
     246<span id="configuration-daemon-archive"></span><h3><a class="toc-backref" href="#id42">archive</a><a class="headerlink" href="#archive" title="Permalink to this headline">¶</a></h3>
    214247<p>This section contains the configuration parameters that modify the way the
    215248daemon saves data to disk, using one of the storage backends.</p>
    216249<p>These are all the available parameters in this section:</p>
    217250<div class="section" id="enabled">
    218 <span id="configuration-daemon-archive-enabled"></span><h4><a class="toc-backref" href="#id24">enabled</a><a class="headerlink" href="#enabled" title="Permalink to this headline">¶</a></h4>
     251<span id="configuration-daemon-archive-enabled"></span><h4><a class="toc-backref" href="#id43">enabled</a><a class="headerlink" href="#enabled" title="Permalink to this headline">¶</a></h4>
    219252<p>Default: <tt class="docutils literal"><span class="pre">true</span></tt></p>
    220253<p>Enables/disables the <em>archives</em> feature. When enabled, Mailjam saves copies of
    … …  
    229262</div>
    230263<div class="section" id="configuration-daemon-archive-backend">
    231 <span id="id4"></span><h4><a class="toc-backref" href="#id25">backend</a><a class="headerlink" href="#configuration-daemon-archive-backend" title="Permalink to this headline">¶</a></h4>
     264<span id="id4"></span><h4><a class="toc-backref" href="#id44">backend</a><a class="headerlink" href="#configuration-daemon-archive-backend" title="Permalink to this headline">¶</a></h4>
    232265<p>Default: <tt class="docutils literal"><span class="pre">json</span></tt></p>
    233266<p>Sets the type of backend used to store messages into the archive.</p>
    … …  
    238271</div>
    239272<div class="section" id="configuration-daemon-archive-path">
    240 <span id="id5"></span><h4><a class="toc-backref" href="#id26">path</a><a class="headerlink" href="#configuration-daemon-archive-path" title="Permalink to this headline">¶</a></h4>
     273<span id="id5"></span><h4><a class="toc-backref" href="#id45">path</a><a class="headerlink" href="#configuration-daemon-archive-path" title="Permalink to this headline">¶</a></h4>
    241274<p>Default: <tt class="docutils literal"><span class="pre">/usr/local/mailjam/archives</span></tt></p>
    242275<p>Path to the directory where the archives will be saved.</p>
    … …  
    248281</div>
    249282<div class="section" id="mailing-lists">
    250 <span id="configuration-daemon-mailing-lists"></span><h3><a class="toc-backref" href="#id27">mailing_lists</a><a class="headerlink" href="#mailing-lists" title="Permalink to this headline">¶</a></h3>
     283<span id="configuration-daemon-mailing-lists"></span><h3><a class="toc-backref" href="#id46">mailing_lists</a><a class="headerlink" href="#mailing-lists" title="Permalink to this headline">¶</a></h3>
    251284<p>This section contains the configuration parameters that set the default
    252285behaviour for mailing lists.</p>
    … …  
    258291<p>These are all the available parameters in this section:</p>
    259292<div class="section" id="private">
    260 <span id="configuration-daemon-mailing-lists-private"></span><h4><a class="toc-backref" href="#id28">private</a><a class="headerlink" href="#private" title="Permalink to this headline">¶</a></h4>
     293<span id="configuration-daemon-mailing-lists-private"></span><h4><a class="toc-backref" href="#id47">private</a><a class="headerlink" href="#private" title="Permalink to this headline">¶</a></h4>
    261294<p>Default: <tt class="docutils literal"><span class="pre">true</span></tt></p>
    262295<p>Sets if a given mailing list is <em>private</em> (only registered members can send
    … …  
    266299</div>
    267300<div class="section" id="members">
    268 <span id="configuration-daemon-members"></span><h3><a class="toc-backref" href="#id29">members</a><a class="headerlink" href="#members" title="Permalink to this headline">¶</a></h3>
     301<span id="configuration-daemon-members"></span><h3><a class="toc-backref" href="#id48">members</a><a class="headerlink" href="#members" title="Permalink to this headline">¶</a></h3>
    269302<p>This section contains the configuration parameters that set the default
    270303behaviour for members.</p>
    … …  
    276309<p>These are all the available parameters in this section:</p>
    277310<div class="section" id="auto-signup">
    278 <span id="configuration-daemon-members-auto-signup"></span><h4><a class="toc-backref" href="#id30">auto_signup</a><a class="headerlink" href="#auto-signup" title="Permalink to this headline">¶</a></h4>
     311<span id="configuration-daemon-members-auto-signup"></span><h4><a class="toc-backref" href="#id49">auto_signup</a><a class="headerlink" href="#auto-signup" title="Permalink to this headline">¶</a></h4>
    279312<p>Default: <tt class="docutils literal"><span class="pre">false</span></tt></p>
    280313<p>Enables/disables auto-registration of members to mailing lists through a public
    … …  
    284317</div>
    285318<div class="section" id="allow-chpasswd">
    286 <span id="configuration-daemon-members-allow-chpasswd"></span><h4><a class="toc-backref" href="#id31">allow_chpasswd</a><a class="headerlink" href="#allow-chpasswd" title="Permalink to this headline">¶</a></h4>
     319<span id="configuration-daemon-members-allow-chpasswd"></span><h4><a class="toc-backref" href="#id50">allow_chpasswd</a><a class="headerlink" href="#allow-chpasswd" title="Permalink to this headline">¶</a></h4>
    287320<p>Default: <tt class="docutils literal"><span class="pre">false</span></tt></p>
    288321<p>Enables/disables the option to update passwords by the members themselves.</p>
    … …  
    290323using a public web interface. If <tt class="docutils literal"><span class="pre">false</span></tt>, only mailing lists administrators
    291324will be able to reset those passwords.</p>
    292 <table class="docutils footnote" frame="void" id="id6" rules="none">
     325</div>
     326</div>
     327</div>
     328<div class="section" id="mailjam-mta-client-configuration-file-mailjam-mta-conf">
     329<span id="configuration-mta-client"></span><h2><a class="toc-backref" href="#id51">Mailjam MTA client configuration file - mailjam-mta.conf</a><a class="headerlink" href="#mailjam-mta-client-configuration-file-mailjam-mta-conf" title="Permalink to this headline">¶</a></h2>
     330<p>This file contains all the parameters to configure the
     331<a class="reference internal" href="overview.html#overview-mailjam-mta-client"><em>MTA client</em></a> properly. It contains ini-style <a class="footnote-reference" href="#id24" id="id6">[1]</a>
     332configuration parameters, separated in different <em>categories</em>.</p>
     333<div class="admonition note">
     334<p class="first admonition-title">Note</p>
     335<p>The mailjam-mta.conf file will be installed in different locations
     336depending on your setup. The usual locations are:</p>
     337<ul class="simple">
     338<li><em>/etc/mailjam/mailjam-mta.conf</em> - In most Linux systems (like archlinux,
     339gentoo, fedora, debian, ubuntu, etc)</li>
     340<li><em>/usr/local/etc/mailjam/mailjam-mta.conf</em> - In most BSD systems (like
     341FreeBSD, OpenBSD, NetBSD, etc)</li>
     342</ul>
     343<p class="last">There is a copy of the configuration file in the <em>conf/</em> directory, within
     344the sources.</p>
     345</div>
     346<div class="section" id="server">
     347<span id="configuration-mta-client-server"></span><h3><a class="toc-backref" href="#id52">server</a><a class="headerlink" href="#server" title="Permalink to this headline">¶</a></h3>
     348<p>This section contains the configuration parameters that tell the MTA client
     349where to connect when trying to interact with the
     350<a class="reference internal" href="overview.html#overview-mailjam-daemon"><em>Mailjam daemon</em></a>.</p>
     351<p>These are all the available parameters in this section:</p>
     352<div class="section" id="configuration-mta-client-server-address">
     353<span id="id7"></span><h4><a class="toc-backref" href="#id53">address</a><a class="headerlink" href="#configuration-mta-client-server-address" title="Permalink to this headline">¶</a></h4>
     354<p>Default: <tt class="docutils literal"><span class="pre">localhost</span></tt></p>
     355<p>The address where the daemon is listening for XMLRPC requests. This is
     356the address to where the client will try to connect to.</p>
     357</div>
     358<div class="section" id="configuration-mta-client-server-port">
     359<span id="id8"></span><h4><a class="toc-backref" href="#id54">port</a><a class="headerlink" href="#configuration-mta-client-server-port" title="Permalink to this headline">¶</a></h4>
     360<p>Default: <tt class="docutils literal"><span class="pre">9876</span></tt></p>
     361<p>The port where the daemon accepts incoming XMLRPC requests. This is the
     362port to where the client will try to connect to.</p>
     363</div>
     364<div class="section" id="uri">
     365<span id="configuration-mta-client-server-uri"></span><h4><a class="toc-backref" href="#id55">uri</a><a class="headerlink" href="#uri" title="Permalink to this headline">¶</a></h4>
     366<p>Default: <a class="reference external" href="http://localhost:9876">http://localhost:9876</a></p>
     367<p>This is the URI <a class="footnote-reference" href="#id27" id="id9">[4]</a> to where the client will connect to. It is constructed
     368based on the values of the <a class="reference internal" href="#configuration-mta-client-server-address"><em>address</em></a>
     369and <a class="reference internal" href="#configuration-mta-client-server-port"><em>port</em></a> parameters.</p>
     370<div class="admonition note">
     371<p class="first admonition-title">Note</p>
     372<p>The default configuration file contains a dynamic setting for this
     373parameter:</p>
     374<div class="highlight-python"><pre>uri = http://%(address)s:%(port)s</pre>
     375</div>
     376<p class="last">That means that the parameter will inherit the values from the
     377<a class="reference internal" href="#configuration-mta-client-server-address"><em>address</em></a>
     378and <a class="reference internal" href="#configuration-mta-client-server-port"><em>port</em></a> parameters.</p>
     379</div>
     380<div class="admonition-see-also admonition seealso">
     381<p class="first admonition-title">See also</p>
     382<p>More information about this (and other tricks) here:</p>
     383<p><a class="reference external" href="http://docs.python.org/library/configparser.html">http://docs.python.org/library/configparser.html</a></p>
     384<p class="last"><a class="reference external" href="http://www.doughellmann.com/PyMOTW/ConfigParser">http://www.doughellmann.com/PyMOTW/ConfigParser</a></p>
     385</div>
     386<div class="admonition warning">
     387<p class="first admonition-title">Warning</p>
     388<p class="last">You can replace this with any URI you would like, <strong>this is the parameter
     389that is really used for establishing new connections</strong> so be aware that if
     390you remove the references to the
     391<a class="reference internal" href="#configuration-mta-client-server-address"><em>address</em></a> and
     392<a class="reference internal" href="#configuration-mta-client-server-port"><em>port</em></a> parameters, the values you have
     393provided for those parameters will be ignored.</p>
     394</div>
     395</div>
     396<div class="section" id="configuration-mta-client-server-ssl">
     397<span id="id10"></span><h4><a class="toc-backref" href="#id56">ssl</a><a class="headerlink" href="#configuration-mta-client-server-ssl" title="Permalink to this headline">¶</a></h4>
     398<p>Default: <tt class="docutils literal"><span class="pre">false</span></tt> (because ssl support hasn&#8217;t been added yet)</p>
     399<p>Enables/disables SSL <a class="footnote-reference" href="#id26" id="id11">[3]</a> connections to the daemon. If <tt class="docutils literal"><span class="pre">false</span></tt> all the
     400traffic to/from the server will travel unencrypted. If <tt class="docutils literal"><span class="pre">true</span></tt> all the traffic
     401will travel encrypted.</p>
     402<div class="admonition warning">
     403<p class="first admonition-title">Warning</p>
     404<p class="last">In order to enable SSL support in the client, you have to be sure the
     405<a class="reference internal" href="overview.html#overview-mailjam-daemon"><em>Mailjam daemon</em></a> supports SSL too (check the
     406<a class="reference internal" href="#configuration-daemon-xmlrpc-ssl"><em>ssl</em></a> parameter in the
     407<a class="reference internal" href="#configuration-daemon-xmlrpc"><em>xmlrpc_server</em></a> section of the
     408<a class="reference internal" href="#configuration-daemon"><em>daemon configuration file</em></a>)</p>
     409</div>
     410</div>
     411</div>
     412<div class="section" id="configuration-mta-client-archive">
     413<span id="id12"></span><h3><a class="toc-backref" href="#id57">archive</a><a class="headerlink" href="#configuration-mta-client-archive" title="Permalink to this headline">¶</a></h3>
     414<p>This section contains the configuration parameters that set where the files
     415generated by the client will be stored/saved.</p>
     416<div class="admonition-see-also admonition seealso">
     417<p class="first admonition-title">See also</p>
     418<p class="last">For more information about the kind of files the client does generate,
     419take a look at the
     420<a class="reference internal" href="overview.html#overview-mailjam-mta-client"><em>MTA client documentation</em></a>.</p>
     421</div>
     422<p>These are all the available parameters in this section:</p>
     423<div class="section" id="persistent">
     424<span id="configurtion-mta-client-archive-persistent"></span><h4><a class="toc-backref" href="#id58">persistent</a><a class="headerlink" href="#persistent" title="Permalink to this headline">¶</a></h4>
     425<p>Default: <tt class="docutils literal"><span class="pre">true</span></tt></p>
     426<p>Enables/disables the local archive for the client. If <tt class="docutils literal"><span class="pre">true</span></tt>, the client
     427will save a copy of every email sent to the list in an internal archive,
     428that could be checked/queried later. If <tt class="docutils literal"><span class="pre">false</span></tt>, the emails will not be
     429kept on disk after being processed.</p>
     430<div class="admonition warning">
     431<p class="first admonition-title">Warning</p>
     432<p class="last">This feature is not ready yet.</p>
     433</div>
     434</div>
     435<div class="section" id="configuration-mta-client-archive-path">
     436<span id="id13"></span><h4><a class="toc-backref" href="#id59">path</a><a class="headerlink" href="#configuration-mta-client-archive-path" title="Permalink to this headline">¶</a></h4>
     437<p>Default: <tt class="docutils literal"><span class="pre">/usr/local/mailjam/archive-mta</span></tt></p>
     438<p>Path to the directory where the archives will be saved.</p>
     439<div class="admonition warning">
     440<p class="first admonition-title">Warning</p>
     441<p class="last">This feature is not ready yet.</p>
     442</div>
     443</div>
     444</div>
     445</div>
     446<div class="section" id="mailjam-cli-client-configuration-file-mailjam-cli-conf">
     447<span id="configuration-cli-client"></span><h2><a class="toc-backref" href="#id60">Mailjam CLI client configuration file - mailjam-cli.conf</a><a class="headerlink" href="#mailjam-cli-client-configuration-file-mailjam-cli-conf" title="Permalink to this headline">¶</a></h2>
     448<p>This file contains all the parameters to configure the
     449<a class="reference internal" href="overview.html#overview-mailjam-cli-client"><em>CLI client</em></a> properly. It contains ini-style <a class="footnote-reference" href="#id24" id="id14">[1]</a>
     450configuration parameters, separated in different <em>categories</em>.</p>
     451<div class="admonition note">
     452<p class="first admonition-title">Note</p>
     453<p>The mailjam-cli.conf file will be installed in different locations
     454depending on your setup. The usual locations are:</p>
     455<ul class="simple">
     456<li><em>/etc/mailjam/mailjam-cli.conf</em> - In most Linux systems (like archlinux,
     457gentoo, fedora, debian, ubuntu, etc)</li>
     458<li><em>/usr/local/etc/mailjam/mailjam-cli.conf</em> - In most BSD systems (like
     459FreeBSD, OpenBSD, NetBSD, etc)</li>
     460</ul>
     461<p class="last">There is a copy of the configuration file in the <em>conf/</em> directory, within
     462the sources.</p>
     463</div>
     464<div class="section" id="configuration-cli-client-server">
     465<span id="id15"></span><h3><a class="toc-backref" href="#id61">server</a><a class="headerlink" href="#configuration-cli-client-server" title="Permalink to this headline">¶</a></h3>
     466<p>This section contains the configuration parameters that tell the cli client
     467where to connect when trying to interact with the
     468<a class="reference internal" href="overview.html#overview-mailjam-daemon"><em>Mailjam daemon</em></a>.</p>
     469<p>These are all the available parameters in this section:</p>
     470<div class="section" id="configuration-cli-client-server-address">
     471<span id="id16"></span><h4><a class="toc-backref" href="#id62">address</a><a class="headerlink" href="#configuration-cli-client-server-address" title="Permalink to this headline">¶</a></h4>
     472<p>Default: <tt class="docutils literal"><span class="pre">localhost</span></tt></p>
     473<p>The address where the daemon is listening for XMLRPC requests. This is
     474the address to where the client will try to connect to.</p>
     475</div>
     476<div class="section" id="configuration-cli-client-server-port">
     477<span id="id17"></span><h4><a class="toc-backref" href="#id63">port</a><a class="headerlink" href="#configuration-cli-client-server-port" title="Permalink to this headline">¶</a></h4>
     478<p>Default: <tt class="docutils literal"><span class="pre">9876</span></tt></p>
     479<p>The port where the daemon accepts incoming XMLRPC requests. This is the
     480port to where the client will try to connect to.</p>
     481</div>
     482<div class="section" id="configuration-cli-client-server-uri">
     483<span id="id18"></span><h4><a class="toc-backref" href="#id64">uri</a><a class="headerlink" href="#configuration-cli-client-server-uri" title="Permalink to this headline">¶</a></h4>
     484<p>Default: <a class="reference external" href="http://localhost:9876">http://localhost:9876</a></p>
     485<p>This is the URI <a class="footnote-reference" href="#id27" id="id19">[4]</a> to where the client will connect to. It is constructed
     486based on the values of the <a class="reference internal" href="#configuration-cli-client-server-address"><em>address</em></a>
     487and <a class="reference internal" href="#configuration-cli-client-server-port"><em>port</em></a> parameters.</p>
     488<div class="admonition note">
     489<p class="first admonition-title">Note</p>
     490<p>The default configuration file contains a dynamic setting for this
     491parameter:</p>
     492<div class="highlight-python"><pre>uri = http://%(address)s:%(port)s</pre>
     493</div>
     494<p class="last">That means that the parameter will inherit the values from the
     495<a class="reference internal" href="#configuration-cli-client-server-address"><em>address</em></a>
     496and <a class="reference internal" href="#configuration-cli-client-server-port"><em>port</em></a> parameters.</p>
     497</div>
     498<div class="admonition-see-also admonition seealso">
     499<p class="first admonition-title">See also</p>
     500<p>More information about this (and other tricks) here:</p>
     501<p><a class="reference external" href="http://docs.python.org/library/configparser.html">http://docs.python.org/library/configparser.html</a></p>
     502<p class="last"><a class="reference external" href="http://www.doughellmann.com/PyMOTW/ConfigParser">http://www.doughellmann.com/PyMOTW/ConfigParser</a></p>
     503</div>
     504<div class="admonition warning">
     505<p class="first admonition-title">Warning</p>
     506<p class="last">You can replace this with any URI you would like, <strong>this is the parameter
     507that is really used for establishing new connections</strong> so be aware that if
     508you remove the references to the
     509<a class="reference internal" href="#configuration-cli-client-server-address"><em>address</em></a> and
     510<a class="reference internal" href="#configuration-cli-client-server-port"><em>port</em></a> parameters, the values you have
     511provided for those parameters will be ignored.</p>
     512</div>
     513</div>
     514<div class="section" id="configuration-cli-client-server-ssl">
     515<span id="id20"></span><h4><a class="toc-backref" href="#id65">ssl</a><a class="headerlink" href="#configuration-cli-client-server-ssl" title="Permalink to this headline">¶</a></h4>
     516<p>Default: <tt class="docutils literal"><span class="pre">false</span></tt> (because ssl support hasn&#8217;t been added yet)</p>
     517<p>Enables/disables SSL <a class="footnote-reference" href="#id26" id="id21">[3]</a> connections to the daemon. If <tt class="docutils literal"><span class="pre">false</span></tt> all the
     518traffic to/from the server will travel unencrypted. If <tt class="docutils literal"><span class="pre">true</span></tt> all the traffic
     519will travel encrypted.</p>
     520<div class="admonition warning">
     521<p class="first admonition-title">Warning</p>
     522<p class="last">In order to enable SSL support in the client, you have to be sure the
     523<a class="reference internal" href="overview.html#overview-mailjam-daemon"><em>Mailjam daemon</em></a> supports SSL too (check the
     524<a class="reference internal" href="#configuration-daemon-xmlrpc-ssl"><em>ssl</em></a> parameter in the
     525<a class="reference internal" href="#configuration-daemon-xmlrpc"><em>xmlrpc_server</em></a> section of the
     526<a class="reference internal" href="#configuration-daemon"><em>daemon configuration file</em></a>)</p>
     527</div>
     528</div>
     529</div>
     530<div class="section" id="history">
     531<span id="configuration-cli-client-history"></span><h3><a class="toc-backref" href="#id66">history</a><a class="headerlink" href="#history" title="Permalink to this headline">¶</a></h3>
     532<p>This section contains the configuration parameters that set the behaviour
     533of the client feature that allows it to save a history of commands provided
     534by the user.</p>
     535<p>These are all the available parameters in this section:</p>
     536<div class="section" id="configurtion-cli-client-archive-enabled">
     537<span id="id22"></span><h4><a class="toc-backref" href="#id67">enabled</a><a class="headerlink" href="#configurtion-cli-client-archive-enabled" title="Permalink to this headline">¶</a></h4>
     538<p>Default: <tt class="docutils literal"><span class="pre">true</span></tt></p>
     539<p>Enables/disables history support in the client. If <tt class="docutils literal"><span class="pre">true</span></tt> all commands
     540provided by an user will be saved to disk. If <tt class="docutils literal"><span class="pre">false</span></tt> nothing will be
     541written to disk.</p>
     542</div>
     543<div class="section" id="configuration-cli-client-history-path">
     544<span id="id23"></span><h4><a class="toc-backref" href="#id68">path</a><a class="headerlink" href="#configuration-cli-client-history-path" title="Permalink to this headline">¶</a></h4>
     545<p>Default: <tt class="docutils literal"><span class="pre">~/.mailjam/cli/history</span></tt></p>
     546<p>Path to the file where the list of executed commands will be saved.</p>
     547<table class="docutils footnote" frame="void" id="id24" rules="none">
    293548<colgroup><col class="label" /><col /></colgroup>
    294549<tbody valign="top">
    295 <tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td><a class="reference external" href="http://en.wikipedia.org/wiki/INI_file">http://en.wikipedia.org/wiki/INI_file</a></td></tr>
     550<tr><td class="label">[1]</td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id6">2</a>, <a class="fn-backref" href="#id14">3</a>)</em> <a class="reference external" href="http://en.wikipedia.org/wiki/INI_file">http://en.wikipedia.org/wiki/INI_file</a></td></tr>
    296551</tbody>
    297552</table>
    298 <table class="docutils footnote" frame="void" id="id7" rules="none">
     553<table class="docutils footnote" frame="void" id="id25" rules="none">
    299554<colgroup><col class="label" /><col /></colgroup>
    300555<tbody valign="top">
    … …  
    302557</tbody>
    303558</table>
    304 <table class="docutils footnote" frame="void" id="id8" rules="none">
     559<table class="docutils footnote" frame="void" id="id26" rules="none">
    305560<colgroup><col class="label" /><col /></colgroup>
    306561<tbody valign="top">
    307 <tr><td class="label"><a class="fn-backref" href="#id3">[3]</a></td><td><a class="reference external" href="http://en.wikipedia.org/wiki/Secure_Socket_Layer">http://en.wikipedia.org/wiki/Secure_Socket_Layer</a></td></tr>
     562<tr><td class="label">[3]</td><td><em>(<a class="fn-backref" href="#id3">1</a>, <a class="fn-backref" href="#id11">2</a>, <a class="fn-backref" href="#id21">3</a>)</em> <a class="reference external" href="http://en.wikipedia.org/wiki/Secure_Socket_Layer">http://en.wikipedia.org/wiki/Secure_Socket_Layer</a></td></tr>
     563</tbody>
     564</table>
     565<table class="docutils footnote" frame="void" id="id27" rules="none">
     566<colgroup><col class="label" /><col /></colgroup>
     567<tbody valign="top">
     568<tr><td class="label">[4]</td><td><em>(<a class="fn-backref" href="#id9">1</a>, <a class="fn-backref" href="#id19">2</a>)</em> <a class="reference external" href="http://en.wikipedia.org/wiki/Uniform_resource_identifier">http://en.wikipedia.org/wiki/Uniform_resource_identifier</a></td></tr>
    308569</tbody>
    309570</table>
    … …  
    322583  <ul>
    323584<li><a class="reference internal" href="#">Configuration</a><ul>
    324 <li><a class="reference internal" href="#mailjam-daemon-configuration-file">Mailjam daemon configuration file</a><ul>
     585<li><a class="reference internal" href="#mailjam-daemon-configuration-file-mailjam-conf">Mailjam daemon configuration file - mailjam.conf</a><ul>
    325586<li><a class="reference internal" href="#xmlrpc-server">xmlrpc_server</a><ul>
    326587<li><a class="reference internal" href="#address">address</a></li>
    … …  
    352613<li><a class="reference internal" href="#auto-signup">auto_signup</a></li>
    353614<li><a class="reference internal" href="#allow-chpasswd">allow_chpasswd</a></li>
     615</ul>
     616</li>
     617</ul>
     618</li>
     619<li><a class="reference internal" href="#mailjam-mta-client-configuration-file-mailjam-mta-conf">Mailjam MTA client configuration file - mailjam-mta.conf</a><ul>
     620<li><a class="reference internal" href="#server">server</a><ul>
     621<li><a class="reference internal" href="#configuration-mta-client-server-address">address</a></li>
     622<li><a class="reference internal" href="#configuration-mta-client-server-port">port</a></li>
     623<li><a class="reference internal" href="#uri">uri</a></li>
     624<li><a class="reference internal" href="#configuration-mta-client-server-ssl">ssl</a></li>
     625</ul>
     626</li>
     627<li><a class="reference internal" href="#configuration-mta-client-archive">archive</a><ul>
     628<li><a class="reference internal" href="#persistent">persistent</a></li>
     629<li><a class="reference internal" href="#configuration-mta-client-archive-path">path</a></li>
     630</ul>
     631</li>
     632</ul>
     633</li>
     634<li><a class="reference internal" href="#mailjam-cli-client-configuration-file-mailjam-cli-conf">Mailjam CLI client configuration file - mailjam-cli.conf</a><ul>
     635<li><a class="reference internal" href="#configuration-cli-client-server">server</a><ul>
     636<li><a class="reference internal" href="#configuration-cli-client-server-address">address</a></li>
     637<li><a class="reference internal" href="#configuration-cli-client-server-port">port</a></li>
     638<li><a class="reference internal" href="#configuration-cli-client-server-uri">uri</a></li>
     639<li><a class="reference internal" href="#configuration-cli-client-server-ssl">ssl</a></li>
     640</ul>
     641</li>
     642<li><a class="reference internal" href="#history">history</a><ul>
     643<li><a class="reference internal" href="#configurtion-cli-client-archive-enabled">enabled</a></li>
     644<li><a class="reference internal" href="#configuration-cli-client-history-path">path</a></li>
    354645</ul>
    355646</li>
Note: See TracChangeset for help on using the changeset viewer.