mirrors/postfixadmin
1
0
Fork 0
mirror of https://github.com/postfixadmin/postfixadmin.git synced 2026-03-28 08:59:55 +00:00
Code Issues Projects Releases Packages Wiki Activity
PostfixAdmin - web based virtual user administration interface for Postfix mail servers https://postfixadmin.github.io/postfixadmin
3,406 commits 11 branches 66 tags 22 MiB
  • PHP 76.4%
  • Smarty 11.2%
  • Perl 7.1%
  • Shell 3.8%
  • Python 0.8%
  • Other 0.7%
Find a file
Exact
wvolz c4a276f26d
 Disable totp and app password pages based on settings (#996) 
- Redirect to main.php if totp ($CONF['totp']) or app password page ($CONF['app_passwords']) is accessed and the config is disabled.
2026-03-27 09:34:18 +00:00
.github/workflows remove php 7.4, 8.0 and 8.1 from the github build action 2026-01-28 09:50:26 +00:00
ADDITIONS mailbox_remover.pl: whitespace fix 2025-10-09 21:57:13 +02:00
configs Upgrade to Bootstrap 5.3.0, add lightmode/darkmode switch, drop datepicker js (use html5 datetime-local) (#987) 2026-02-28 10:17:56 +00:00
debian remove more references to sourceforge 2025-07-13 18:29:37 +01:00
DOCUMENTS Fix PHP version inconsistency 2026-01-27 20:30:32 +01:00
languages WIP: TOTP reset for lost secrets (#988) 2026-02-28 10:15:07 +00:00
model CSRF protection - support multiple tokens (#985) 2026-03-01 19:30:16 +00:00
public Disable totp and app password pages based on settings (#996) 2026-03-27 09:34:18 +00:00
scripts see #992 - try and remove bash-ism from postfixadmin-cli wrapper; manual merge of provided patch 2026-03-24 12:24:21 +00:00
templates hide app_passwords menu items if disabled in config (#995) 2026-03-26 09:30:02 +00:00
tests CSRF protection - support multiple tokens (#985) 2026-03-01 19:30:16 +00:00
VIRTUAL_VACATION Move noreply to conf definable variable 2025-08-19 18:33:46 +01:00
.gitignore Add Domain Key handling 2022-06-23 20:40:06 +02:00
.php-cs-fixer.dist.php PSR2 -> PSR12 formatting 2022-06-28 13:46:11 +01:00
CHANGELOG.TXT update changelog 2025-09-12 21:04:58 +01:00
common.php CSRF protection - support multiple tokens (#985) 2026-03-01 19:30:16 +00:00
composer-update.sh I know people say not to add vendor/ to git, but this is the --no-dev variant, and it should handle autoloading too ... 2021-10-22 22:29:26 +01:00
composer.json see #989 - allow newer version of spomky-labs/otphp, which removes some unnecessary dependencies and silences some PHP 8.4 warnings 2026-03-11 09:27:03 +00:00
config.inc.php Merge pull request #957 from postfixadmin/psalm-fixes 2026-02-11 20:53:07 +00:00
functions.inc.php CSRF protection - support multiple tokens (#985) 2026-03-01 19:30:16 +00:00
GPL-LICENSE.TXT Initial Import in SourceForge 2007-03-24 07:27:00 +00:00
index.php Add a index.php showing a note about the "public" directory 2018-04-26 21:33:11 +02:00
INSTALL.md rename INSTALL.TXT to INSTALL.md 2026-01-28 09:50:26 +00:00
install.sh Merge pull request #957 from postfixadmin/psalm-fixes 2026-02-11 20:53:07 +00:00
LICENSE.TXT LICENSE.TXT: 2011-04-24 16:15:21 +00:00
password_expiration.sql rename sql fields to just have mailbox.password_expiry and domain.password_expiry 2018-08-28 21:19:56 +01:00
phpunit.xml fix path 2021-06-11 22:18:20 +01:00
postfixadmin.my.cnf Better (aka safer) way to deal with authentication 2018-08-17 22:15:02 +02:00
psalm.xml CSRF protection - support multiple tokens (#985) 2026-03-01 19:30:16 +00:00
README.md docs: update README.md with better PHP version requirements 2026-02-15 11:25:25 +00:00
SECURITY.md Create SECURITY.md 2021-08-02 20:27:17 +01:00

README.md

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)

Useful Links

Related Projects

  • 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