Commit Graph
115 Commits
Author SHA1 Message Date
Rodrigo Cortés Cano 3ab0104d1a Address forwarding editor review feedback 2026-07-22 18:13:16 +00:00
Rodrigo Cortés Cano 9a9078ce21 Unify user and admin forwarding editor 2026-07-22 18:13:16 +00:00
Rodrigo Cortés Cano 63f91b649f Clarify sudoers rules across optional hook sets (#1082)
- Clarifies that the documented `sudoers` policy applies to every enabled PostfixAdmin hook, not only to the optional Rspamd integration.
- Explains which generic rules remain in place and when the composite Rspamd domain-deletion rule replaces the direct domain-deletion rule.

thanks @TrapoSAMA
2026-07-19 19:38:09 +01:00
Rodrigo Cortés Cano f3e10ce573 Harden optional mailbox hooks and add Rspamd DKIM examples (#1079)
- harden the existing optional Maildir domain, mailbox creation/deletion and Dovecot mail-crypt hooks
- validate hook argument contracts and keep all derived paths below their configured base directories
- quote filesystem operations, check command failures and make deletion hooks safely retryable
- update the Dovecot password example for the prompt behaviour available since Dovecot 2.3.19, with a Dovecot 2.4 setting note 
- add optional Rspamd DKIM creation/deletion helpers, a privilege-separated composite domain hook and deployment documentation

These hooks remain optional and disabled by default. Administrators must review the configured paths and service-account names before installation. The mail-crypt password example now requires Dovecot 2.3.19 or newer; its comment identifies the setting name needed by Dovecot 2.4.
2026-07-19 09:50:48 +01:00
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
Kent Riboe c51d00cefb docs: document the language-string workflow (#1070) (#1071)
Refresh the Translation process 
 * rename DOCUMENTS/LANGUAGE.txt to DOCUMENTS/Translations.md, attempt to format.
 * Removes the dead SVN / SourceForge references, points at GitHub.
 * Add a **"for developers"** section etc

Thanks @knofte
2026-07-07 20:37:59 +01:00
snathan100 4b3f7e70ea Add docs: custom fields via *_struct_hook (with domain backend_host example) (#1069)
As discussed in #1068.

Adds `DOCUMENTS/CUSTOM_FIELDS.md`, a start-to-finish walkthrough for
adding a custom field to a built-in entity using the `*_struct_hook`
callbacks, no core patching required.
2026-07-05 20:12:02 +01:00
Kent Riboe 8e6a4f0f4b Add developer documentation for Handler classes, update PFAHandler::pacol() params (#1008)
Add DOCUMENTS/HANDLER_CLASSES.md which attempts to document how the Handler classes work and help future developers/contributors. 

Changes spec of PFAHandler::pacol() to discourage the 9th parameter (was: multiopt) from being passed as an array (param renamed to not_in_db). Previous behaviour is maintained, but a deprecation error should be triggered.
2026-04-18 10:10:00 +01:00
Sven Strickroth b90e891de7 Fix PHP version inconsistency
Signed-off-by: Sven Strickroth <email@cs-ware.de>
2026-01-27 20:30:32 +01:00
David Goodwin 0b9147c32d Update HASHING.md
update docs (note mysql_encrypt isn't wired in / working / available, properly link to issue etc)
2025-05-28 09:41:22 +01:00
David Goodwin 1cac965d88 Update POSTFIX_CONF.txt
add missing example file for smtpd_Sender_login_maps
2025-05-26 15:04:47 +01:00
David Goodwin 798e8b269c Topt app passwords fixes (WIP) (#805)
various improvements to the TOTP code see also:  #802
2025-05-16 20:31:20 +01:00
David Goodwin f1153a09ab remove unused, stale, screenshots 2024-11-22 21:49:19 +00:00
David Goodwin 3cb22ed23c see #857 - update screenshots 2024-11-22 21:10:51 +00:00
David Goodwin 5047f9d1d4 stop smarty moaning about an undefined div on list.php 2024-11-22 20:32:56 +00:00
Marcus Deglos cbce0c1909 Fix configuration typo (#866)
Add dollar symbol to variables (master.cf in docs) - thanks @manarth
2024-11-09 14:44:05 +00:00
John Fawcett 8a314079bd Updates to POSTFIX_CONF.txt for configuration of authenticaiton with
dovecot sasl and configuration of Postfix submission service
2024-01-09 23:15:57 +01:00
John Fawcett 668960ccf6 Add a flag to mailbox table for enable/disable smtp protocol. The table column name
is "smtp_active". This enables use of this flag instead of active flag for postfix
mysql queries. There is a new configuration parameter $CONF['smtp_active_flag'] =
YES or NO, which defaults to NO, providing the existing behaviour. When set to YES
the active_smtp field is displayed in the edit mode and can be modified.
The commit includes update to the language files and documentation.

The commit does not include the code to add the field to existing installs,
which I presume can be added during the release cycle in upgrade.php along the
lines of:

_db_add_field('mailbox',  'smtp_active', 'int DEFAULT 1');
2024-01-09 20:50:49 +01:00
David Goodwin 4d17aa6ef9 manaul merge in of verdigado:master (see #753) (MFA/TOTP support) 2023-12-23 17:05:52 +00:00
knofte 2ea74cabb7 Typos fix - Update UPGRADE.txt
A few simple typos fixed.
2023-09-18 20:13:39 +03:00
David Goodwin 9f91c55b24 typos 2023-06-17 19:21:05 +01:00
David Goodwin 0344e729d0 see https://github.com/postfixadmin/postfixadmin/issues/704 - add documentation 2023-02-03 14:33:16 +00:00
David Goodwin 6ffbc9ffe4 update docs, see also https://github.com/postfixadmin/postfixadmin/issues/653 2022-09-01 09:23:07 +01:00
David Goodwin 6b83c2bb0f see https://github.com/postfixadmin/postfixadmin/issues/640 - password expiration doc update 2022-07-22 20:37:04 +01:00
David Goodwin d3e101e9d8 Merge remote-tracking branch 'origin/master' into feature/dkim 2022-07-18 08:55:07 +01:00
David Goodwin 071ca11502 try to harden the example expiry script in DOCUMENTS/Password_Expiration.md#expiration-script - thanks to @jumecittu - see https://github.com/postfixadmin/postfixadmin/issues/619 2022-07-17 20:09:38 +01:00
Freddo bced89c78c Update screenshots/README.md 2022-06-23 20:46:33 +02:00
Fredrik Falk 9e73025058 Add Domain Key handling 2022-06-23 20:40:06 +02:00
Christian Boltz c4c7753740 SECURITY.txt: whitespace fixes 2022-06-06 18:35:28 +02:00
David Goodwin aa1b80d173 add iterate_query for dovecot 2022-04-22 11:23:23 +01:00
Antony c11f014e7c update mysql_transport_maps.cf - translate 'virtual' to ':'
This makes sure our internal/virtual domains aren't caught in other transport map/nexthop

I needed this to safely implement transport rules like .fr => relay:[smtp.relay.com] without smashing our internal domains

So found out that transparent transport was ':' but took me a wile, so thought I could share.
2022-03-07 23:13:39 -04:00
Davide Beatrici 3934add185 DOCUMENTS: Configure "smtpd_sender_login_maps" in Dovecot & PostgreSQL example
A short explanation is also added.
2021-11-28 14:42:29 +01:00
David Goodwin ed1dc78816 Update HASHING.md 2021-11-21 15:35:44 +00:00
Yudi Purwanto 9d65a5004c Change notication to notification 2021-11-19 16:24:17 +07:00
Mirko Vogt e467af14e1 default $transport_maps: exclude results where transport='virtual'
Modify the default query for $transport_maps to exclude all entries
which have the transport set to 'virtual'.

Postfixadmin sets the transport for domains to 'virtual' by default,
which is a rather unfortunate choice when enabling transport_maps, as
it will direct postfix to use the 'virtual' transport as defined in
master.cf, which most likely is not what the user intended.
The user most likely still wants emails being delivered to virtual
mailboxes, via the transport defined per $virtual_transport.

$virtual_transport however is only a fallback, which applies if
$transport_maps is either undefined or the table lookup it refers to
fails.

Hence excluding domains where transport is set to 'virtual', which
by default and therewith in most cases probably means all domains
ever created by postfixadmin.

This results in the query returning no results, leading to postfix
falling back to the transport defined in $virtual_transport.
2021-11-12 17:12:52 +01:00
David Goodwin 0b9b7db917 Merge remote-tracking branch 'origin/master' into feature-improve-pacrypt 2021-09-29 18:04:49 +01:00
Thanassis Zakopoulos cbac254d60 Update Password_Expiration.md
This line should be like this:

        echo -e "Dear User, \n Your password will expire on ${RESULT[1]}" | mail -s "Password $INTERVAL days before expiration notication" -r $REPLY_ADDRESS  ${RESULT[0]} 


instead of 

        echo -e "Dear User, \n Your password will expire on ${RESULT[1]}" | mail -s "Password 30 days before expiration notication" -r $REPLY_ADDRESS  ${RESULT[0]} 

otherwise the subject will always be 30 days no matter what the $INTERVAL is
2021-07-23 12:56:03 +03:00
David Goodwin 28a4baf857 Merge remote-tracking branch 'origin/feature-improve-pacrypt' into feature-improve-pacrypt 2021-07-07 21:45:25 +01:00
David Goodwin c3d3978daf Update README.md
refresh screenshots with bootstrap theme etc.
2021-06-12 21:23:06 +01:00
David Goodwin e9cea4d4c4 update screenshots perhaps 2021-06-12 21:09:42 +01:00
David Goodwin 8bd608e2f2 Update HASHING.md
reformat so it might look better in plain text
2021-05-24 20:56:07 +01:00
David Goodwin 659b242b59 merge fix 2021-05-15 21:28:19 +01:00
Andrey Miroshnichenko 9cda7f402c Minor fixes of the password expiration checker script example. 2021-05-13 00:54:41 +03:00
David Goodwin 543285a203 add SSHA format, add some specific courier algorithms, try and partially update docs 2021-05-09 21:31:53 +01:00
David Goodwin cc2e049050 see: https://github.com/postfixadmin/postfixadmin/issues/468 - token docs on possible migration 2021-03-07 13:34:39 +00:00
David Goodwin 3979e17499 token updates 2021-01-29 21:19:07 +00:00
David Goodwin 154629d732 remove out of date bits 2021-01-29 21:18:47 +00:00
David Goodwin cfe08d14f5 rename / merge shell script 2021-01-29 21:14:35 +00:00
David Goodwin 96d071dffd add something to the FAQ to help people find error messages 2021-01-26 19:06:19 +00:00
David Goodwin 7ec7f10290 reference config.local.php 2021-01-26 09:35:42 +00:00