Postfix Admin Console

Overview

Postfix Admin Console is a Drupal Recipe for adding the PostfixAdmin module to an existing Drupal site.

The base Recipe provides a focused installation for existing sites. An optional dedicated-site preset provides a complete PostfixAdmin operator console.

Features

• Install PostfixAdmin and its required configuration through a Drupal Recipe.
• Create a dedicated postfix_administrator role with only the permissions needed to operate PostfixAdmin.
• Keep the base Recipe suitable for existing sites by preserving their current theme, front page, and administration layout.
• Use the optional dedicated-site preset to configure Drupal core's Default Admin theme and dark mode.
• Enable the primary and secondary local task blocks required for the resource-list tabs and contextual + action.
• Use the Domain list as the starting page for a dedicated PostfixAdmin site.

Run locally

docker pull pixieworks/postfix_admin_console:latest
docker run --detach --rm \
  --name postfix-admin-console \
  -p 127.0.0.1:8080:80 \
  pixieworks/postfix_admin_console:latest
docker logs postfix-admin-console

Dedicated-site preset

Apply the base Recipe when adding PostfixAdmin to an existing Drupal site. Apply the optional dedicated-site preset when building a focused administration console for mail operators.

The preset configures the Default Admin theme, dark mode, local task blocks, and the Domain list front page. It provides direct access to Domain list, Alias list, Mailbox list, Alias domain list, Settings, and the contextual + action.

Documentation

See the Postfix Admin Console documentation for installation, the base Recipe, the dedicated-site preset, permissions, verification, and development guidance.

Report problems and feature requests in the project's issue queue.

Installation

Install the Recipe, PostfixAdmin, and Drush with Composer:

composer require drush/drush:^13 drupal/postfix_admin:^1.0@beta drupal/postfix_admin_console:^1.0@beta

From the Drupal web root, apply the base Recipe:

../vendor/bin/drush recipe ../recipes/postfix_admin_console

For a dedicated PostfixAdmin site, apply the optional preset after the base Recipe:

../vendor/bin/drush recipe ../recipes/postfix_admin_console/examples/dedicated-site

Requirements

• Drupal ^11.4 || ^12
• PHP 8.3 or later
• Composer
• PostfixAdmin 1.x