aerc-smtp - SMTP configuration for aerc(1)

Authors

Originally created by Drew DeVault and maintained by Robin Jarry who is assisted by other open source contributors. For more information about aerc development, see https://sr.ht/~rjarry/aerc/. 2025-05-31 AERC-SMTP(5)

Configuration

Basic 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 SMTP with STARTTLS smtp+insecure SMTP without STARTTLS 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-domain = <domain> Local domain name to use in the HELO/EHLO SMTP command. Set this to a fully qualified domain name if the server requires it as an antispam measure. Default: localhost