This is a minimally maintained fork of the original postfix-logwatch
from the `logreporters project <https://logreporters.sourceforge.net/>`_.
It should work with the latest postfix, but large-scale
improvements and refactorings are out of scope.

Overview
========

The postfix-logwatch utility is a postfix log parser that produces
summaries, details, and statistics regarding the operation of
postfix.

A key feature of postfix-logwatch is its ability to produce a very
wide range of reports with data grouped and sorted as much as possible
to reduce noise and highlight patterns. Brief summary reports provide
a quick overview of general postfix operations and message scanning,
calling out warnings that may require attention. Detailed reports
provide easy to scan, hierarchically-arranged and organized
information, with as much or little detail as desired.

Installation
============

Copy ``postfix-logwatch`` to the location of your choosing, mark it
executable, and run it. The path to the config file is hard-coded
in the script, to ``/usr/local/etc/postfix-logwatch.conf``. If you
want to customize the reports, edit the included example config
and place it there (or point the script to a better location).

Usage
=====

Basic usage:

.. code-block:: console

   $ postfix-logwatch /path/to/mail.log

For brief help:

.. code-block:: console

   $ postfix-logwatch --help

See the ``postfix-logwatch.1`` man page for complete details, and see
comments in the ``postfix-logwatch.conf`` file for additional
information.

Bugs
====

Send bugs to michael@orlitzky.com, or report them on `Codeberg
<https://codeberg.org/mjo/postfix-logwatch/issues>`_.
