pixieworks/postfix_admin_console repository overview

⁠Postfix Admin Console Docker demo

This is a disposable, evaluation-only image for trying the Postfix Admin Console look and feel. It is built from the Drupal Official Image, installs SQLite, applies both the base Recipe and the dedicated-site preset, and creates a non-UID-1 operator account at first start.

It is not a production mail platform. It does not include Postfix, Dovecot, DNS, TLS, mail delivery, existing site data, or site secrets. Do not expose the port publicly or use the image with production data.

⁠Try it 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

Wait for the first-install message. Open the login URL shown in the log, or use http://localhost:8080/user/login?destination=/admin/structure/postfix_admin/domain⁠. The generated username and password are shown in the container log at startup. Keep the log private.

The credentials and persisted Drupal settings are retained in the running container at /var/lib/postfix-admin-console/secrets/, outside the web root and readable only by root. The SQLite database is at /var/lib/postfix-admin-console/data/postfix-admin-console.sqlite, also outside the web root. A restart preserves them. Passing a different username or password to an already initialized container fails instead of silently changing the account.

Set POSTFIX_ADMIN_CONSOLE_USERNAME and POSTFIX_ADMIN_CONSOLE_PASSWORD on the first docker run to choose the operator credentials. The username site_owner is reserved for the internal UID 1 account. Credentials must not contain control characters such as newlines or tabs.

Stop and discard the demo with:

docker stop postfix-admin-console

The default --rm and no-volume invocation intentionally discards the demo on stop. Run the command again for a clean site and newly generated password. An occupied host port can be changed, for example 127.0.0.1:8081:80.

⁠Build and test

The Dockerfile pins the Drupal Official Image digest and installs:

• drush/drush:^13
• drupal/postfix_admin:1.0.0-beta1
• drupal/postfix_admin_console:1.0.0-alpha2

Build one platform and run the network-isolated smoke test with Docker:

docker build --platform linux/amd64 -t postfix-admin-console-demo:local .
sh smoke-test.sh postfix-admin-console-demo:local

The repository workflow builds and tests both linux/amd64 and linux/arm64. It does not log in to Docker Hub or push an image. The latest tag is published only by the manually dispatched publication workflow after hosted preview approval.