aerc-smtp - Man Page

SMTP configuration for aerc(1)

Synopsis

aerc implements the SMTP protocol as specified by RFC 5321.

Configuration

SMTP configuration may be done interactively with the :new-account command.

In accounts.conf (see aerc-accounts(5)), the following SMTP-specific options are available:

outgoing = <scheme>+<auth>://<username>[:<password>]@<hostname>[:<port>]?[<oauth2_params>]

Remember that all fields must be URL encoded. The @ symbol, when URL encoded, is %40.

The value of <scheme> can be:

smtp

Unencrypted SMTP

smtps

SMTP with TLS/SSL

Additionally, you can specify an authentication mechanism like so:

none

No authentication is required to use this SMTP server. You may omit the username and password in this case.

plain

Authenticate with a username and password using AUTH PLAIN. This is the default behavior.

login

Authenticate with a username and password using AUTH LOGIN. This is an obsolete protocol, but is required for some common webmail providers.

oauthbearer

SMTP with TLS/SSL using OAUTHBEARER Authentication. See documentation in aerc-imap(5) for usage.

xoauth2

SMTP with TLS/SSL using XOAUTH2 Authentication. See documentation in aerc-imap(5) for usage.

outgoing-cred-cmd = <command>

Specifies the command to run to get the password for the SMTP account. This command will be run using sh -c [command]. If a password is specified in the outgoing option, the password will take precedence over this command.

Example:

outgoing-cred-cmd = pass hostname/username

smtp-starttls = true|false

Set this to true if the server uses STARTTLS. In that case you should also use smtp:// instead of smtps://.

Default: false

See Also

aerc(1) aerc-accounts(5)

Authors

Originally created by Drew DeVault <sir@cmpwn.com> and maintained by Robin Jarry <robin@jarry.cc> who is assisted by other open source contributors. For more information about aerc development, see https://sr.ht/~rjarry/aerc/.

Referenced By

aerc(1), aerc-accounts(5), aerc-config(5), aerc-maildir(5), aerc-notmuch(5).

2023-01-18