Woozle: saving work; done?

2011-06-07T11:55:28Z

saving work; done?

New page

==About==
* '''parameter''': mailbox_command
* '''default''': (empty)
* '''versions''': ?

Optional external command that the [[Postfix/local|local]] delivery agent should use for mailbox delivery. The command is run with the user ID and the primary group ID privileges of the recipient. Exception:
command delivery for root executes with $[[../default_privs|default_privs]] privileges. This is not a problem, because:
# mail for root should always be aliased to a real user and
# don't log in as root, use "su" instead.
===Environment===
The following environment variables are exported to the command:
; CLIENT_ADDRESS : Remote client network address. Available in Postfix version 2.2 and later.
; CLIENT_HELO : Remote client EHLO command parameter. Available in Postfix version 2.2 and later.
; CLIENT_HOSTNAME : Remote client hostname. Available in Postfix version 2.2 and later.
; CLIENT_PROTOCOL : Remote client protocol. Available in Postfix version 2.2 and later.
; DOMAIN : The domain part of the recipient address.
; EXTENSION : The optional address extension.
; HOME : The recipient home directory.
; LOCAL : The recipient address localpart.
; LOGNAME : The recipient's username.
; ORIGINAL_RECIPIENT : The entire recipient address, before any address rewriting or aliasing.
; RECIPIENT : The full recipient address.
; SASL_METHOD : SASL authentication method specified in the remote client AUTH command. Available in Postfix version 2.2 and later.
; SASL_SENDER : SASL sender address specified in the remote client MAIL FROM command. Available in Postfix version 2.2 and later.
; SASL_USER : SASL username specified in the remote client AUTH command. Available in Postfix version 2.2 and later.
; SENDER : The full sender address.
; SHELL : The recipient's login shell.
; USER : The recipient username.

Unlike other Postfix configuration parameters, the '''mailbox_command''' parameter is not subjected to $name substitutions. This is to make it easier to specify shell syntax (see example below).

If you can, avoid shell meta characters because they will force Postfix to run an expensive shell process. If you're delivering via [[Procmail]] then running a shell won't make a noticeable difference in the total cost.

Note: if you use the '''mailbox_command''' feature to deliver mail system-wide, you must set up an alias that forwards mail for root to a real user.

The precedence of [[Postfix/local|local]] delivery features from high to low is: aliases, .forward files, [[../mailbox_transport_maps|mailbox_transport_maps]], [[../mailbox_transport|mailbox_transport]],
[[../mailbox_command_maps|mailbox_command_maps]], [[../mailbox_command|mailbox_command]], [[../home_mailbox|home_mailbox]], [[../mail_spool_directory|mail_spool_directory]],
[[../fallback_transport_maps|fallback_transport_maps]], [[../fallback_transport|fallback_transport]] and [[../luser_relay|luser_relay]].

Examples:

* mailbox_command = /some/where/procmail
* mailbox_command = /some/where/procmail -a "$EXTENSION"
* mailbox_command = /some/where/maildrop -d "$USER" -f "$SENDER" "$EXTENSION"

Postfix/main.cf/mailbox command - Revision history

Woozle: saving work; done?