.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "AERC-SMTP" "5" "2024-07-30"
.PP
.SH NAME
.PP
aerc-smtp - SMTP configuration for \fBaerc\fR(1)
.PP
.SH SYNOPSIS
.PP
aerc implements the SMTP protocol as specified by RFC 5321.\&
.PP
.SH CONFIGURATION
.PP
Basic SMTP configuration may be done interactively with the \fB:new-account\fR
command.\&
.PP
In \fIaccounts.\&conf\fR (see \fBaerc-accounts\fR(5)), the following SMTP-specific options
are available:
.PP
\fBoutgoing\fR = \fI<scheme>\fR[\fI+<auth>\fR]://\fI<username>\fR[\fI:<password>\fR]\fI@<hostname>\fR[\fI:<port>\fR]?\&[\fI<oauth2_params>\fR]
.RS 4
Remember that all fields must be URL encoded.\& The \fI@\fR symbol, when URL
encoded, is \fI%40\fR.\&
.PP
The value of \fI<scheme>\fR can be:
.PP
\fIsmtp\fR
.RS 4
SMTP with STARTTLS
.PP
.RE
\fIsmtp+insecure\fR
.RS 4
SMTP without STARTTLS
.PP
.RE
\fIsmtps\fR
.RS 4
SMTP with TLS/SSL
.PP
.RE
Additionally, you can specify an authentication mechanism like so:
.PP
\fInone\fR
.RS 4
No authentication is required to use this SMTP server.\& You may omit the
username and password in this case.\&
.PP
.RE
\fIplain\fR
.RS 4
Authenticate with a username and password using AUTH PLAIN.\& This is the
default behavior.\&
.PP
.RE
\fIlogin\fR
.RS 4
Authenticate with a username and password using AUTH LOGIN.\& This is an obsolete
protocol, but is required for some common webmail providers.\&
.PP
.RE
\fIoauthbearer\fR
.RS 4
SMTP with TLS/SSL using OAUTHBEARER Authentication.\& See
documentation in \fBaerc-imap\fR(5) for usage.\&
.PP
.RE
\fIxoauth2\fR
.RS 4
SMTP with TLS/SSL using XOAUTH2 Authentication.\& See
documentation in \fBaerc-imap\fR(5) for usage.\&
.PP
.RE
.RE
\fBoutgoing-cred-cmd\fR = \fI<command>\fR
.RS 4
Specifies the command to run to get the password for the SMTP
account.\& This command will be run using \fIsh -c [command]\fR.\& If a
password is specified in the \fBoutgoing\fR option, the password will
take precedence over this command.\&
.PP
Example:
.RS 4
outgoing-cred-cmd = pass hostname/username
.PP
.RE
.RE
\fBsmtp-domain\fR = \fI<domain>\fR
.RS 4
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.\&
.PP
Default: \fIlocalhost\fR
.PP
.RE
.SH SEE ALSO
.PP
\fBaerc\fR(1) \fBaerc-accounts\fR(5)
.PP
.SH AUTHORS
.PP
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 \fIhttps://sr.\&ht/~rjarry/aerc/\fR.\&