source: mailjam/docs/src/configuration.rst

Last change on this file was 27:b1d527287347, checked in by Borja Lopez <borja@…>, 12 years ago

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 size: 15.2 KB

Configuration

Mailjam has separate configuration files for the different apps (the daemon and the variety of different clients available). Check below to read more about the configuration file you need to modify depending on what you want to do.

Mailjam daemon configuration file - mailjam.conf

All the configurations that can be applied to the :ref:`overview_mailjam_daemon` are registered in the mailjam.conf file. That file contains ini-style [1] configuration parameters, separated in different categories.

?

Note

The mailjam.conf file will be installed in different locations depending on your setup. The usual locations are:

  • /etc/mailjam/mailjam.conf - In most Linux systems (like archlinux, gentoo, fedora, debian, ubuntu, etc)
  • /usr/local/etc/mailjam/mailjam.conf - In most BSD systems (like FreeBSD, OpenBSD, NetBSD, etc)

There is a copy of the configuration file in the conf/ directory, within the sources.

xmlrpc_server

This section contains the configuration parameters that modify the behaviour of the daemon when serving content through XMLRPC [2].

These are all the available parameters in this section:

address

Default: localhost

The address where the daemon will be listening for XMLRPC requests. Use * to listen an all available addresses, or any specific hostname or ip address value.

port

Default: 9876

The port where the daemon will be listening por XMLRPC requests.

ssl

Default: false (because ssl support hasn't been added yet)

Enables/disables SSL [3] support in the daemon. If false all the traffic to/from the server will travel unencrypted. If true all the traffic will travel encrypted.

ssl_key

Default: /usr/local/etc/mailjam/ssl/mailjam.key

Path to the ssl key used for encrypted SSL sessions.

Warning

This parameter is not used right now, as ssl support hasn't been added yet)

ssl_crt

Default: /usr/local/etc/mailjam/ssl/mailjam.crt

Path to the ssl certificate used for encrypted SSL sessions.

Warning

This parameter is not used right now, as ssl support hasn't been added yet)

logfile

Default: /var/log/mailjam/xmlrpc_server.log

Path to the file where log messages will be saved

storage

This section contains the configuration parameters that modify the way the daemon saves data to disk, using one of the storage backends.

These are all the available parameters in this section:

backend

Default: json

Sets the type of backend the daemon is going to use. Right now the only backend available is json.

path

Default: /usr/local/mailjam/storage

Path to the directory where the backend will save data.

lists_db

Default: /usr/local/mailjam/storage/mailings.json

Path to the file where the identifiers of existing mailing lists will be saved.

Note

The default configuration file contains a dynamic setting for this parameter:

lists_db = %(path)s/mailings.%(backend)s

That means that the parameter will inherit the values of the base path and the extension of the file from the storage.path and storage.backend settings.

?
.. seealso::

   More information about this (and other tricks) here:

   http://docs.python.org/library/configparser.html

   http://www.doughellmann.com/PyMOTW/ConfigParser

members_db

Default: /usr/local/mailjam/storage/members.json

Path to the file where the identifiers of existing members will be saved.

Note

The same notes as for the lists_db parameter apply to this configuration parameter.

archive

This section contains the configuration parameters that modify the way the daemon saves data to disk, using one of the storage backends.

These are all the available parameters in this section:

enabled

Default: true

Enables/disables the archives feature. When enabled, Mailjam saves copies of email address into an archive, so they can be read later, through a web interface.

To disable that feature, set this to false.

Warning

This feature is not ready yet, so it doesn't matter if you set this to true or false

backend

Default: json

Sets the type of backend used to store messages into the archive.

Warning

This feature is not ready yet.

path

Default: /usr/local/mailjam/archives

Path to the directory where the archives will be saved.

Warning

This feature is not ready yet.

mailing_lists

This section contains the configuration parameters that set the default behaviour for mailing lists.

Warning

This parameters are not currently used in mailjam, we are still working on per-mailing-list configuration parameters.

These are all the available parameters in this section:

private

Default: true

Sets if a given mailing list is private (only registered members can send messages to the list) or not (anyone can send messages to the list).

If false, by default all new lists will not be private.

members

This section contains the configuration parameters that set the default behaviour for members.

Warning

This parameters are not currently used in mailjam, we are still working on per-member configuration parameters.

These are all the available parameters in this section:

auto_signup

Default: false

Enables/disables auto-registration of members to mailing lists through a public web application. If true, users can register themselves into mailing lists using a public web interface. If false, only mailing lists administrators will be able to add new members to the list.

allow_chpasswd

Default: false

Enables/disables the option to update passwords by the members themselves.

If true, members of a mailing list will be able to update their passwords using a public web interface. If false, only mailing lists administrators will be able to reset those passwords.

Mailjam MTA client configuration file - mailjam-mta.conf

This file contains all the parameters to configure the :ref:`overview_mailjam_mta_client` properly. It contains ini-style [1] configuration parameters, separated in different categories.

?

Note

The mailjam-mta.conf file will be installed in different locations depending on your setup. The usual locations are:

  • /etc/mailjam/mailjam-mta.conf - In most Linux systems (like archlinux, gentoo, fedora, debian, ubuntu, etc)
  • /usr/local/etc/mailjam/mailjam-mta.conf - In most BSD systems (like FreeBSD, OpenBSD, NetBSD, etc)

There is a copy of the configuration file in the conf/ directory, within the sources.

server

This section contains the configuration parameters that tell the MTA client where to connect when trying to interact with the :ref:`overview_mailjam_daemon`.

?

These are all the available parameters in this section:

address

Default: localhost

The address where the daemon is listening for XMLRPC requests. This is the address to where the client will try to connect to.

port

Default: 9876

The port where the daemon accepts incoming XMLRPC requests. This is the port to where the client will try to connect to.

uri

Default: http://localhost:9876

This is the URI [4] to where the client will connect to. It is constructed based on the values of the :ref:`configuration_mta_client_server_address` and :ref:`configuration_mta_client_server_port` parameters.

??

Note

The default configuration file contains a dynamic setting for this parameter:

uri = http://%(address)s:%(port)s

That means that the parameter will inherit the values from the :ref:`configuration_mta_client_server_address` and :ref:`configuration_mta_client_server_port` parameters.

??
?
.. seealso::

   More information about this (and other tricks) here:

   http://docs.python.org/library/configparser.html

   http://www.doughellmann.com/PyMOTW/ConfigParser

Warning

You can replace this with any URI you would like, this is the parameter that is really used for establishing new connections so be aware that if you remove the references to the :ref:`configuration_mta_client_server_address` and :ref:`configuration_mta_client_server_port` parameters, the values you have provided for those parameters will be ignored.

??

ssl

Default: false (because ssl support hasn't been added yet)

Enables/disables SSL [3] connections to the daemon. If false all the traffic to/from the server will travel unencrypted. If true all the traffic will travel encrypted.

Warning

In order to enable SSL support in the client, you have to be sure the :ref:`overview_mailjam_daemon` supports SSL too (check the :ref:`configuration_daemon_xmlrpc_ssl` parameter in the :ref:`configuration_daemon_xmlrpc` section of the :ref:`daemon configuration file <configuration_daemon>`)

????

archive

This section contains the configuration parameters that set where the files generated by the client will be stored/saved.

?
.. seealso::

   For more information about the kind of files the client does generate,
   take a look at the
   :ref:`MTA client documentation <overview_mailjam_mta_client>`.

These are all the available parameters in this section:

persistent

Default: true

Enables/disables the local archive for the client. If true, the client will save a copy of every email sent to the list in an internal archive, that could be checked/queried later. If false, the emails will not be kept on disk after being processed.

Warning

This feature is not ready yet.

path

Default: /usr/local/mailjam/archive-mta

Path to the directory where the archives will be saved.

Warning

This feature is not ready yet.

Mailjam CLI client configuration file - mailjam-cli.conf

This file contains all the parameters to configure the :ref:`overview_mailjam_cli_client` properly. It contains ini-style [1] configuration parameters, separated in different categories.

?

Note

The mailjam-cli.conf file will be installed in different locations depending on your setup. The usual locations are:

  • /etc/mailjam/mailjam-cli.conf - In most Linux systems (like archlinux, gentoo, fedora, debian, ubuntu, etc)
  • /usr/local/etc/mailjam/mailjam-cli.conf - In most BSD systems (like FreeBSD, OpenBSD, NetBSD, etc)

There is a copy of the configuration file in the conf/ directory, within the sources.

server

This section contains the configuration parameters that tell the cli client where to connect when trying to interact with the :ref:`overview_mailjam_daemon`.

?

These are all the available parameters in this section:

address

Default: localhost

The address where the daemon is listening for XMLRPC requests. This is the address to where the client will try to connect to.

port

Default: 9876

The port where the daemon accepts incoming XMLRPC requests. This is the port to where the client will try to connect to.

uri

Default: http://localhost:9876

This is the URI [4] to where the client will connect to. It is constructed based on the values of the :ref:`configuration_cli_client_server_address` and :ref:`configuration_cli_client_server_port` parameters.

??

Note

The default configuration file contains a dynamic setting for this parameter:

uri = http://%(address)s:%(port)s

That means that the parameter will inherit the values from the :ref:`configuration_cli_client_server_address` and :ref:`configuration_cli_client_server_port` parameters.

??
?
.. seealso::

   More information about this (and other tricks) here:

   http://docs.python.org/library/configparser.html

   http://www.doughellmann.com/PyMOTW/ConfigParser

Warning

You can replace this with any URI you would like, this is the parameter that is really used for establishing new connections so be aware that if you remove the references to the :ref:`configuration_cli_client_server_address` and :ref:`configuration_cli_client_server_port` parameters, the values you have provided for those parameters will be ignored.

??

ssl

Default: false (because ssl support hasn't been added yet)

Enables/disables SSL [3] connections to the daemon. If false all the traffic to/from the server will travel unencrypted. If true all the traffic will travel encrypted.

Warning

In order to enable SSL support in the client, you have to be sure the :ref:`overview_mailjam_daemon` supports SSL too (check the :ref:`configuration_daemon_xmlrpc_ssl` parameter in the :ref:`configuration_daemon_xmlrpc` section of the :ref:`daemon configuration file <configuration_daemon>`)

????

history

This section contains the configuration parameters that set the behaviour of the client feature that allows it to save a history of commands provided by the user.

These are all the available parameters in this section:

enabled

Default: true

Enables/disables history support in the client. If true all commands provided by an user will be saved to disk. If false nothing will be written to disk.

path

Default: ~/.mailjam/cli/history

Path to the file where the list of executed commands will be saved.

[1](1, 2, 3) http://en.wikipedia.org/wiki/INI_file
[2]http://en.wikipedia.org/wiki/XML-RPC
[3](1, 2, 3) http://en.wikipedia.org/wiki/Secure_Socket_Layer
[4](1, 2) http://en.wikipedia.org/wiki/Uniform_resource_identifier
Note: See TracBrowser for help on using the repository browser.