Rodrigo Cortés Cano e280deb97a Document Dovecot 2.4 configuration (#1075)
Add Dovecot 2.4-oriented documentation for PostfixAdmin installations.

The new document covers:

- baseline Dovecot 2.4 SQL passdb/userdb configuration
- temporary weak password scheme compatibility for old MD5/MD5-CRYPT
hashes
- optional post-login password migration to ARGON2ID
- optional per-user Maildir to mdbox migration using a local mail_format
field
- quota warning delivery to the user's INBOX
- optional IMAPSieve/Rspamd spam and ham learning hooks
- security notes for userdb_plain_pass and verbose password logging

It also adds sanitized example files under DOCUMENTS/examples and
references the new Dovecot 2.4 document from the existing DOVECOT and
HASHING docs.

Thanks @TrapoSAMA
2026-07-13 08:49:50 +01:00
2026-07-07 21:27:27 +01:00
2026-06-27 16:31:22 +01:00
2026-07-12 09:13:30 +01:00
2007-03-24 07:27:00 +00:00
2026-01-28 09:50:26 +00:00
2011-04-24 16:15:21 +00:00
2021-08-02 20:27:17 +01:00

GitHubBuild Coverage Status GitHub repo size IRC Chat - #postfixadmin

PostfixAdmin

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 or PostgreSQL)
  • Fetchmail (optional)

Features

  • 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 can login, change their password and/or setup a vacation (out of office) auto responder.
  • Integration with Squirrelmail or Roundcube (via plugins)
  • Optional XMLRPC based API
  • Supports TOTP challenges (and optional IP address based exemptions) for login
  • Supports Application Specific Passwords (where you can have multiple passwords for a mailbox - e.g. one for your mobile device, and a different one for your desktop)
  • Supports Domain Key (DKIM) storage

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

Hosting Requirements

  • Requires PHP 8.2+ (master), if you need support for older PHP versions, try the 3.3 branch which supports PHP 7.0 and up.
  • Database (MySQL, PostgreSQL or Sqlite)
  • Requires Apache / Nginx webserver (that's capable of integration with PHP)

Releases

  • 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 /stable release - see: https://github.com/postfixadmin/postfixadmin/releases or its branch (e.g. postfixadmin_4.0)
  • 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. Also update db_min_version in functions.inc.php if there were changes in upgrade.php.

Development Notes

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)
  • 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
S
Description
PostfixAdmin - веб-интерфейс виртуального администрирования пользователей для почтовых серверов Postfix
Readme
26 MiB
0 Stars 1 Watchers 0 Forks
Languages
PHP 82.3%
Go Template 8.8%
Shell 4.1%
Perl 4.1%
Python 0.5%