aerc-smtp - SMTP configuration for aerc(1)
aerc implements the SMTP protocol as specified by RFC 5321.
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
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/.