summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/mailman/docs/MTA.rst52
1 files changed, 52 insertions, 0 deletions
diff --git a/src/mailman/docs/MTA.rst b/src/mailman/docs/MTA.rst
index 5ca86307e..ac38c3026 100644
--- a/src/mailman/docs/MTA.rst
+++ b/src/mailman/docs/MTA.rst
@@ -297,6 +297,58 @@ with Exim configuration, you probably want to start with the chapter on
.. _`how Exim receives and delivers mail`: http://www.exim.org/exim-html-current/doc/html/spec_html/ch-how_exim_receives_and_delivers_mail.html
+qmail
+=====
+
+qmail_ is a MTA written by djb_ and, though old and not updated, still
+bulletproof and occassionally in use.
+
+Mailman settings
+----------------
+
+Mostly defaults in mailman.cfg::
+
+ [mta]
+ # NullMTA is just implementing the interface and thus satisfying Mailman
+ # without doing anything fancy
+ incoming: mailman.mta.null.NullMTA
+ # Mailman should not be run as root.
+ # Use any convenient port > 1024. 8024 is a convention, but can be
+ # changed if there is a conflict with other software using that port.
+ lmtp_port: 8024
+
+This will listen on localhost:8024 with LMTP and deliver outgoing
+messages to localhost:25. See ``mailman/config/schema.cfg`` for more
+information on these settings.
+
+qmail configuration
+-------------------
+
+It is assumed that qmail is configured to use the ``.qmail*`` files in a user’s
+home directory, however the instructions should easily be adaptable to other
+qmail configurations. However, it is required that Mailman has a (sub)domain
+respectively a namespace on its own. A helper script called ``qmail-lmtp`` is
+needed and can be found in the ``contrib/`` directory of the Mailman source
+tree and assumed to be on ``$PATH`` here.
+
+As qmail puts every namespace in the address, we have to filter it out again.
+If your main domain is ``example.com`` and you assign ``lists.example.com`` to
+the user ``mailman``, qmail will give you the destination address
+``mailman-spam@lists.example.com`` while it should actually be
+``spam@lists.example.com``. The second argument to ``qmail-lmtp`` defines
+how many parts (separated by dashes) to filter out. The first argument
+specifies the LMTP port of mailman. Long story short, as user mailman:
+::
+
+ % chmod +t "$HOME"
+ % echo '|qmail-lmtp 1 8042' > .qmail # put appropriate values here
+ % ln -sf .qmail .qmail-default
+ % chmod -t "$HOME"
+
+.. _qmail: https://cr.yp.to/qmail.html
+.. _djb: https://cr.yp.to
+
+
Sendmail
========