1aerc-smtp(5)                  File Formats Manual                 aerc-smtp(5)
2
3
4

NAME

6       aerc-smtp - SMTP configuration for aerc(1)
7

SYNOPSIS

9       aerc implements the SMTP protocol as specified by RFC 5321.
10

CONFIGURATION

12       SMTP configuration may be done interactively with the :new-account com‐
13       mand.
14
15       In accounts.conf (see aerc-config(5)), the following SMTP-specific op‐
16       tions are available:
17
18       outgoing
19           smtp[s][+plain|+login|+none|+oauthbearer]://username[:pass‐
20           word]@hostname[:port]?[:oauth2_params]
21
22           Remember that all fields must be URL encoded. The "@" symbol, when
23           URL encoded, is %40.
24
25           The meaning of the scheme component is:
26
27           smtp://:
28               Unencrypted SMTP
29
30           smtps://:
31               SMTP with TLS/SSL
32
33           Additionally, you can specify an authentication mechanism like so:
34
35           +none:
36               No authentication is required to use this SMTP server. You may
37               omit the username and password in this case.
38
39           +plain:
40               Authenticate with a username and password using AUTH PLAIN.
41               This is the default behavior.
42
43           +login:
44               Authenticate with a username and password using AUTH LOGIN.
45               This is an obsolete protocol, but is required for some common
46               webmail providers.
47
48           +oauthbearer:
49               SMTP with TLS/SSL using OAUTHBEARER Authentication.  See docu‐
50               mentation in aerc-imap(5) for usage.
51
52       outgoing-cred-cmd
53           Specifies the command to run to get the password for the SMTP ac‐
54           count. This command will be run using `sh -c [command]`. If a pass‐
55           word is specified in the outgoing option, the password will take
56           precedence over this command.
57
58           Example:
59
60           pass hostname/username
61
62       smtp-starttls
63           Set this to `yes` if the server uses STARTTLS. In that case you
64           should also use smtp instead of smtps.
65

SEE ALSO

67       aerc(1) aerc-config(5)
68

AUTHORS

70       Originally created by Drew DeVault <sir@cmpwn.com> and maintained by
71       Robin Jarry <robin@jarry.cc> who is assisted by other open source con‐
72       tributors. For more information about aerc development, see
73       https://sr.ht/~rjarry/aerc/.
74
75
76
77                                  2022-06-18                      aerc-smtp(5)