cdist-type__dma(7)

NAME

cdist-type__dma - Setup the DragonFly Mail Agent as the MTA.

DESCRIPTION

This (singleton) type uses DMA, a small Mail Transport Agent (MTA), to accept mails from locally installed Mail User Agents (MUA) and either deliver the mails to a remote smart host for delivery or communicate with remote SMTP servers directly.

REQUIRED PARAMETERS

None.

BOOLEAN PARAMETERS

defer

If enabled, mail will not be sent immediately, but stored in a queue. To flush the queue and send the mails, `dma -q has to be run periodically (e.g. using a cron job.) This type does not manage such a cron job, but some operating systems ship such a cron job with the package.

fullbounce

Enable if bounce messages should include the complete original message, not just the headers.

nullclient

Enable to bypass aliases and local delivery, and instead forward all mails to the defined --smarthost.

send-test-mail

If set, this type will send a test email to root after setup, to check if the configured settings work.

OPTIONAL PARAMETERS

mailname

If present, this will be the hostname used to identify this host and the remote part of the sender addresses. If not defined, it defaults to /etc/mailname on Debian derivatives and to __target_fqdn otherwise. See dma(8) for more information.

Note: on Debian derivatives the /etc/mailname file should be updated instead of using this parameter.

masquerade

Masquerade the envelope-from addresses with this address/hostname. Use this setting if mails are not accepted by destination mail servers because your sender domain is invalid. This option can be used multiple times. For more information see the dma(8) man page.

port

The port on which to deliver email. If not provided, a sensible default port will be used based on the --security argument.

security

Configures whether and how DMA should use secure connections.

ssl/tls

Enable TLS/SSL secured transfer.

starttls

Use STARTTLS to establish a secure connection.

opportunistic (default)

Will try to establish a secure connection using STARTTLS, but allow unencrypted transfer if STARTTLS fails. Most useful when dma is used without a smarthost, delivering remote messages directly to the outside mail exchangers.

insecure

allow plain text SMTP login over an insecure connection. Should really not be used anymore!

smarthost

The mail server used to send email. It must be configured to act as a relay for the host being configured by this type so that mail can be sent to users non-local to the smarthost.

EXAMPLES

# Install DMA and use the smarthost mx1.domain.tld to send mail.
__dma --smarthost mx1.domain.tld --send-test-mail

# Install DMA in a default configuration.
__dma

SEE ALSO

AUTHORS

Evilham <contact@evilham.com> Dennis Camera <dennis.camera@ssrq-sds-fds.ch>

COPYING

Copyright (C) 2020 Evilham and Dennis Camera. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.