Installing pagure's milter

==========================

A milter is a script that is ran by a Mail Transfer Agent (`MTA

<https: en.wikipedia.org="" message_transfer_agent="" wiki="">`_)</https:>

upon receiving an email via either a network or an unix socket.

If you want more information feel free to check out the corresponding page

on wikipedia: `https://en.wikipedia.org/wiki/Milter

<https: en.wikipedia.org="" milter="" wiki="">`_.</https:>

Configure your system

---------------------

* Install the required dependencies

::

    python-pymilter

.. note:: We ship a systemd unit file for pagure_milter but we welcome patches

        for scripts for other init systems.

.. note:: It also requires a MTA, we used postfix.

* Create an alias ``reply``

This can be done in ``/etc/aliases``, for example:

::

    reply:      /dev/null

* Activate the ability of your MTA, to split users based on the character ``+``.

  This way all the emails sent to ``reply+...@example.com`` will be forwarded

  to your alias for ``reply``.

In postfix this is done via:

::

    recipient_delimiter = +

* Hook the milter in the MTA

In postfix this is done via:

::

    non_smtpd_milters = unix:/var/run/pagure/paguresock

    smtpd_milters = unix:/var/run/pagure/paguresock

* Install the files of the milter as follow:

+---------------------------------------------+---------------------------------------------------+

|                  Source                     |                   Destination                     |

+=============================================+===================================================+

| ``pagure-milters/comment_email_milter.py``  | ``/usr/share/pagure/comment_email_milter.py``     |

+---------------------------------------------+---------------------------------------------------+

| ``pagure-milters/milter_tempfile.conf``     | ``/usr/lib/tmpfiles.d/pagure-milter.conf``        |

+---------------------------------------------+---------------------------------------------------+

| ``pagure-milters/pagure_milter.service``    | ``/etc/systemd/system/pagure_milter.service``     |

+---------------------------------------------+---------------------------------------------------+

The first file is the script of the milter itself.

The second file is a file specific for systemd and ensuring the temporary

folders needed by the milter are re-created if needed at each boot.

The third file is the systemd service file.

* Activate the service and ensure it's started upon boot:

::

    systemctl enable pagure_milter

    systemctl start pagure_milter