NAME

       aerc-smtp - 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/.

                                            2023-01-06                               AERC-SMTP(5)