postfix relay #1

Supports: focal bionic xenial trusty
Add to new model

Description

Postfix is the default mail transport agent on Ubuntu. This charm implements a mail relay for cloud instances.


Postfix Relay

Overview

This Postfix charm implements a naive mail relay for cloud instances. It is expected that it will be used as a simple transport to a more intelligent upstream relay.

This is a reactive rewrite of ~paulgear/trusty/postfix-relay-0 which is based on the postfix charm by:

Maintainers

BootStack Charmers bootstack-charmers@lists.canonical.com

TODO

Provide juju actions to

  • add/remove/list postconf entries?
  • add/remove/list aliases
  • remove/list entries in the mail queue?

Configuration

disable_vrfy_command
(boolean) Disable the SMTP VRFY command. This isn't usually useful for relays.
True
domain_rewrite_map
(string) A list of domain:newdomain pairs to rewrite. Primarily used for allowing hosts with locally-resolvable domain names to send mail which appears to be from a real domain. Addresses in these domains will be rewritten from user@host.domain to user+host@newdomain.
myhostname
(string) The external hostname by which this mail relay is known. This value must be changed for the charm to be useful.
postfix-relay.example.com
mynetworks
(string) A comma-separated list of networks for which this relay will allow sending mail.
127.0.0.0/8
nagios_context
(string) Used by the nrpe subordinate charms. A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them.
juju
nagios_servicegroups
(string) A comma-separated list of nagios servicegroups. If left empty, the nagios_context will be used as the servicegroup
relayhost
(string) An upstream mail relay, sometimes called "smart host". Enclose it in square brackets to skip MX lookup.
smtp_auth_password
(string) Password to auth against remote mail server using smtp_auth_username. Requires smtp_auth_username to take effect.
smtp_auth_username
(string) Username to auth against remote mail server. Requires smtp_auth_password to take effect.
smtpd_helo_required
(boolean) Require that a remote SMTP client sends HELO or EHLO before commencing a MAIL transaction.
True
smtpd_recipient_restrictions
(string) Optional restrictions which the Postfix SMTP server applies in the context of a client RCPT TO command.
permit_mynetworks, reject_non_fqdn_recipient, reject_unknown_recipient_domain, reject_unauth_pipelining
ssl_ca
(string) Base64-encoded SSL CA to use with the upstream relay host. If set postfix will assume the upstream host is using TLS and configure itself accordingly.