Postfix Admin
=============

Postfix Admin provides Drupal entities and administration forms for managing
domains, mailboxes, and aliases stored in Drupal's database. Postfix reads the
routing data through separately configured SQL lookup maps.

Requirements
------------

* Drupal 11.4 or later, including Drupal 12.
* PHP 8.3 or later.
* A separately configured Postfix service with access to the routing tables.

Installation
------------

Install the module with Composer:

    composer require drupal/postfix_admin

Enable the module with Drush or the Extend page. See `INSTALL.txt` for the
initial configuration steps.

Configuration
-------------

After enabling the module, configure alias email validation at
`/admin/config/services/postfix_admin/settings`. Then add domains before creating
mailboxes or aliases. Configure Postfix's database connection in its SQL maps,
following `docs/sql-map-contract.md` and `examples/postfix/`.

The module creates its Drupal entity tables but does not install or configure
Postfix or mail delivery. Configure and secure those services separately.

Documentation
-------------

Documentation is available at
https://project.pages.drupalcode.org/postfix_admin/.

License
-------

Postfix Admin is licensed under the GNU General Public License, version 2 or
later.
