mailserver2/postfixadmin

What is this?

PostfixAdmin is a web based interface used to manage mailboxes, virtual domains and aliases. It also features support for vacation/out-of-the-office messages.

Features

• Lightweight & secure image (no root process)
• Based on Alpine Linux
• Latest Postfixadmin version (3.3.13)
• MariaDB/PostgreSQL driver
• With PHP8

Built-time variables

• VERSION : version of postfixadmin
• SHA256_HASH : SHA256 hash of Postfixadmin archive

Ports

• 8888

Environment variables

Variable	Description	Type	Default value
UID	postfixadmin user id	optional	991
GID	postfixadmin group id	optional	991
DBDRIVER	Database type: mysql, pgsql	optional	mysql
DBHOST	Database instance ip/hostname	optional	mariadb
DBPORT	Database instance port	optional	3306
DBUSER	Database database username	optional	postfix
DBNAME	Database database name	optional	postfix
DBPASS	Database database password or location of a file containing it	required	null
SMTPHOST	SMTP server ip/hostname	optional	mailserver
DOMAIN	Mail domain	optional	domainname value
ENCRYPTION	Passwords encryption method	optional	dovecot:SHA512-CRYPT
PASSVAL_MIN_LEN	Passwords validation: minimum password length	optional	5
PASSVAL_MIN_CHAR	Passwords validation: must contain at least characters	optional	3
PASSVAL_MIN_DIGIT	Passwords validation: must contain at least digits	optional	2
PAGE_SIZE	Number of entries (mailboxes, alias, etc) that you would like to see in one page.	optional	10
QUOTA_MULTIPLIER	Number of bytes required to represent a single quota unit. You can either use '1000000', '1024000' or '1048576'	optional	1024000
FETCHMAIL_EXTRA_OPTIONS	Allows to pass additional options to fetchmail	optional	NO

• If you use this docker image and mailserver2/mailserver with fetchmail support enabled, a dedicated port (10025) is available with less restrictions for delivery. Use FETCHMAIL_EXTRA_OPTIONS environment variable for that purpose. Example :

postfixadmin:
  environment:
    FETCHMAIL_EXTRA_OPTIONS="smtp localhost/10025"

Docker-compose.yml

# Full example :
# https://github.com/mailserver2/mailserver/blob/master/docker-compose.sample.yml

postfixadmin:
  image: mailserver2/postfixadmin
  container_name: postfixadmin
  domainname: domain.tld
  hostname: mail
  environment:
    - DBPASS=xxxxxxx
  depends_on:
    - mailserver
    - mariadb # postgres (adjust accordingly)

How to setup

https://github.com/mailserver2/mailserver/wiki/Postfixadmin-initial-configuration