aboutsummaryrefslogtreecommitdiffstats
path: root/doc/aerc-smtp.5.scd
blob: 850a71b2a5be01fb70a626f86348415bd49e4e0b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
AERC-SMTP(5)

# 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_

*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_

# 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/.