An open source, web based interface for managing domains/mailboxes/aliases etc on a Postfix based mail server.

Integrates with :

• Postfix
• IMAP/POP3 server (e.g. Dovecot or Courier)
• Database backend (choose one of: sqlite, mysql, postgresql)
• Fetchmail (optional)

• Unlimited domains/aliases/mailboxes
• Optional storage quota support
• Optional password expiry (beta)
• Multiple password hashing formats
• Supports PostgreSQL, MySQL, MariaDB, SQLite database backends (choose one)
• Supports retrieval of mail from a remote POP3 server (via fetchmail)
• Vacation / Autoresponder / Out Of Office support
• Users have the ability to login, change their password or vacation (out of office) status.
• Integration with Squirrelmail / Roundcube (via plugins)
• Optional XMLRPC based API
• Supports PHP7.2+ (older versions of PHP should work with older releases)

Some screenshots of Postfixadmin in action (as admin and user)

• While you can install PostfixAdmin from 'git' using the 'master' branch, 'master' is our main development version. It may work. It may contain funky new exciting stuff. It may "eat your data".
• If you want an easy life, use a published release - see: https://github.com/postfixadmin/postfixadmin/releases or its branch (e.g. postfixadmin_3.3)
• Latest significant changes should be listed in the appropriate CHANGELOG.TXT file.
• From 2025/06 we should be using SemVer releases (e.g. 4.0.1-beta1, and not postfixadmin-4.0.1-beta1 for tags etc)
• Before a new release, try to remember to edit config.inc.php and change the version variable.

Github actions is configured to run unit tests, once something is appropriately pushed, or * run vendor/bin/phpunit tests (but this will not test against different PHP versions).

You should be able to use ACT (https://github.com/nektos/act) to run the tests locally, this will require docker etc.

• composer format - should fix styling issues (spaces etc in the code)
• composer psalm - should detect some obvious errors (e.g. a typo in a function name, referencing an invalid class etc)

• Probably all you need to read (pdf)
• Docker Images
• What is it? (txt)
• Installation instructions
• Wiki
• IRC channel (#postfixadmin on Libera.chat).

• https://github.com/aqeltech/Dockerised-GUI-Mailserver
• https://github.com/mailserver2/mailserver mailserver2/mailserver is a simple and full-featured mail server build as a set of multiple docker images. Features: Postfix, PostfixAdmin, Dovecot, Rspamd, Clamav, Zeyple, Sieve, Fetchmail, Rainloop, Unbound/NSD, Træfik, {Let's Encrypt,custom,Self-signed Certificate} SSL, Supports PostgeSQL, MySQL, (beta) LDAP backends. Automated builds on DockerHub and Integration tests with Travis CI