From 47f1ffe65c3fbf31ac74f7065e779f5d51bbdeb6 Mon Sep 17 00:00:00 2001 From: Jean-Denis Vauguet Date: Sun, 31 May 2020 04:52:34 +0200 Subject: [PATCH] Updated Configure Aliases (markdown) --- .../content/config/user-management/aliases.md | 29 ++++++++++++------- 1 file changed, 18 insertions(+), 11 deletions(-) diff --git a/docs/content/config/user-management/aliases.md b/docs/content/config/user-management/aliases.md index 2bf3107a..99f4c85d 100644 --- a/docs/content/config/user-management/aliases.md +++ b/docs/content/config/user-management/aliases.md @@ -2,36 +2,43 @@ Please first read [Postfix documentation on virtual aliases](http://www.postfix. ### Configuring aliases -Aliases are managed in `config/postfix-virtual.cf`. -An alias is a full email address that will be: -* delivered to an existing account in `config/postfix-accounts.cf` +Aliases are managed in `/tmp/docker-mailserver/postfix-aliases.cf`. + +An alias is a _full_ email address that will either be: + +* delivered to an existing account registered in `/tmp/docker-mailserver/postfix-accounts.cf` * redirected to one or more other email addresses Alias and target are space separated. -Example: +Example (on a server with domain.tld as its domain): - # Alias to existing account + # Alias delivered to an existing account alias1@domain.tld user1@domain.tld - # Forward to external email address + # Alias forwarded to an external email address alias2@domain.tld external@gmail.com ### Configuring regexp aliases -Additional regexp aliases can be configured by placing them into `config/postfix-regexp.cf`. The regexp aliases get evaluated after the virtual aliases (postfix-virtual.cf). For example, the following `config/postfix-regexp.cf` causes all email to "test" users to be delivered to qa@example.com: +Additional regexp aliases can be configured by placing them into `config/postfix-regexp.cf`. The regexp aliases get evaluated after the virtual aliases (/tmp/docker-mailserver/postfix-aliases.cf). + +For example, the following `config/postfix-regexp.cf` causes all email to "test" users to be delivered to qa@example.com: ``` /^test[0-9][0-9]*@example.com/ qa@example.com ``` -### Address tags as an alternative +### Address tags (extension delimiters) as an alternative to aliases -Postfix supports address tags - i.e. address+tag@example.com will end up at address@example.com. This is configured by default and the (configurable) separator is set to `+`. +Postfix supports so-called address tags, in the form of plus (+) tags - i.e. address+tag@example.com will end up at address@example.com. -For more info, see [How to use Address Tagging (user+tag@example.com) with Postfix](https://www.stevejenkins.com/blog/2011/03/how-to-use-address-tagging-usertagexample-com-with-postfix/). +This is configured by default and the (configurable !) separator is set to `+`. + +For more info, see [How to use Address Tagging (user+tag@example.com) with Postfix](https://www.stevejenkins.com/blog/2011/03/how-to-use-address-tagging-usertagexample-com-with-postfix/) and the [official documentation](http://www.postfix.org/postconf.5.html#recipient_delimiter). + +Note that if you do decide to change the configurable separator, you must add the same line to *both* `config/postfix-main.cf` and `config/dovecot.cf`, because Dovecot is acting as the delivery agent. For example, to switch to `-`, add: -Note that if you do decide to change the configurable separator, you must add the same line to *both* `config/postfix-main.cf` and `config/dovecot.cf`, because Dovecot is acting as the delivery agent. For example, to switch to `-`, add ``` recipient_delimiter = - ```