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-accounts(5)), the following SMTP-specific
16       options are available:
17
18       outgoing = <scheme>[+<auth>]://<username>[:<password>]@<host‐
19       name>[:<port>]?[<oauth2_params>]
20           Remember that all fields must be URL encoded. The @ symbol, when
21           URL encoded, is %40.
22
23           The value of <scheme> can be:
24
25           smtp
26               SMTP with STARTTLS
27
28           smtp+insecure
29               SMTP without STARTTLS
30
31           smtps
32               SMTP with TLS/SSL
33
34           Additionally, you can specify an authentication mechanism like so:
35
36           none
37               No authentication is required to use this SMTP server. You may
38               omit the username and password in this case.
39
40           plain
41               Authenticate with a username and password using AUTH PLAIN.
42               This is the default behavior.
43
44           login
45               Authenticate with a username and password using AUTH LOGIN.
46               This is an obsolete protocol, but is required for some common
47               webmail providers.
48
49           oauthbearer
50               SMTP with TLS/SSL using OAUTHBEARER Authentication. See docu‐
51               mentation in aerc-imap(5) for usage.
52
53           xoauth2
54               SMTP with TLS/SSL using XOAUTH2 Authentication. See documenta‐
55               tion in aerc-imap(5) for usage.
56
57       outgoing-cred-cmd = <command>
58           Specifies the command to run to get the password for the SMTP ac‐
59           count. This command will be run using sh -c [command]. If a pass‐
60           word is specified in the outgoing option, the password will take
61           precedence over this command.
62
63           Example:
64               outgoing-cred-cmd = pass hostname/username
65
66       smtp-domain = <domain>
67           Local domain name to use in the HELO/EHLO SMTP command. Set this to
68           a fully qualified domain name if the server requires it as an anti‐
69           spam measure.
70
71           Default: localhost
72

SEE ALSO

74       aerc(1) aerc-accounts(5)
75

AUTHORS

77       Originally created by Drew DeVault <sir@cmpwn.com> and maintained by
78       Robin Jarry <robin@jarry.cc> who is assisted by other open source con‐
79       tributors. For more information about aerc development, see
80       https://sr.ht/~rjarry/aerc/.
81
82
83
84                                  2023-07-19                      AERC-SMTP(5)