.\" Generated by scdoc 1.11.2 .\" 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-ACCOUNTS" "5" "2023-04-23" .P .SH NAME .P aerc-accounts - account configuration file format for \fBaerc\fR(1) .P .SH SYNOPSIS .P The \fIaccounts.\&conf\fR file is used for configuring each mail account used for aerc.\& It is expected to be in your XDG config home plus \fIaerc\fR, which defaults to \fI~/.\&config/aerc/accounts.\&conf\fR.\& This file must be kept secret, as it may include your account credentials.\& .P If \fIaccounts.\&conf\fR does not exist, the \fB:new-account\fR configuration wizard will be executed automatically on first startup.\& .P This file is written in the ini format where each \fB[section]\fR is the name of an account you want to configure, and the keys & values in that section specify details of that account'\&s configuration.\& In addition to the options documented here, specific transports for incoming and outgoing emails may have additional configuration parameters, documented on their respective man pages.\& .P .SH CONFIGURATION .P Note that many of these configuration options are written for you, such as \fBsource\fR and \fBoutgoing\fR, when you run the account configuration wizard (\fB:new-account\fR).\& .P \fBarchive\fR = \fI\fR .RS 4 Specifies a folder to use as the destination of the \fB:archive\fR command.\& .P Default: \fIArchive\fR .P .RE \fBcheck-mail\fR = \fI\fR .RS 4 Specifies an interval to check for new mail.\& Mail will be checked at startup, and every interval.\& IMAP accounts will check for mail in all unselected folders, and the selected folder will continue to receive PUSH mail notifications.\& Maildir/Notmuch folders must use \fBcheck-mail-cmd\fR in conjunction with this option.\& See \fBaerc-maildir\fR(5) and \fBaerc-notmuch\fR(5) for more information.\& .P Setting this option to \fI0\fR will disable \fBcheck-mail\fR .P Example: .RS 4 \fBcheck-mail\fR = \fI5m\fR .P .RE Default: \fI0\fR .P .RE \fBcopy-to\fR = \fI\fR .RS 4 Specifies a folder to copy sent mails to, usually \fISent\fR.\& .P .RE \fBdefault\fR = \fI\fR .RS 4 Specifies the default folder to open in the message list when aerc configures this account.\& .P Default: \fIINBOX\fR .P .RE \fBfolders\fR = \fI\fR .RS 4 Specifies the comma separated list of folders to display in the sidebar.\& Names prefixed with \fI~\fR are interpreted as regular expressions.\& .P By default, all folders are displayed.\& .P .RE \fBfolders-exclude\fR = \fI\fR .RS 4 Specifies the comma separated list of folders to exclude from the sidebar.\& Names prefixed with \fI~\fR are interpreted as regular expressions.\& Note that this overrides anything from \fBfolders\fR.\& .P By default, no folders are excluded.\& .P .RE \fBenable-folders-sort\fR = \fItrue\fR|\fIfalse\fR .RS 4 If \fItrue\fR, folders are sorted, first by specified folders (see \fBfolders-sort\fR), then alphabetically.\& .P Default: \fItrue\fR .P .RE \fBfolders-sort\fR = \fI\fR .RS 4 Specifies a comma separated list of folders to be shown at the top of the list in the provided order.\& Remaining folders will be sorted alphabetically.\& .P .RE \fBfrom\fR = \fI
\fR .RS 4 The default value to use for the From header in new emails.\& This should be an RFC 5322-compatible string, such as \fIYour Name \fR.\& .P .RE \fBaliases\fR = \fI\fR .RS 4 All aliases of the current account.\& These will be used to fill in the From: field.\& Make sure that your email server accepts this value, or for example use \fBaerc-sendmail\fR(5) in combination with \fBmsmtp\fR(1) and \fB--read-envelope-from\fR.\& .P .RE \fBoutgoing\fR = \fI\fR .RS 4 Specifies the transport for sending outgoing emails on this account.\& It should be a connection string, and the specific meaning of each component varies depending on the protocol in use.\& See each protocol'\&s man page for more details: .P .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .IP \(bu 4 .\} \fBaerc-sendmail\fR(5) .RE .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .IP \(bu 4 .\} \fBaerc-smtp\fR(5) .RE .P .RE \fBoutgoing-cred-cmd\fR = \fI\fR .RS 4 Specifies an optional command that is run to get the outgoing account'\&s password.\& See each protocol'\&s man page for more details.\& .P .RE \fBoutgoing-cred-cmd-cache\fR = \fItrue\fR|\fIfalse\fR .RS 4 By default, the credentials returned by the command will be cached until aerc is shut down.\& If set to \fIfalse\fR, \fBoutgoing-cred-cmd\fR will be executed every time an email is to be sent.\& .P Default: \fItrue\fR .P .RE \fBpgp-auto-sign\fR = \fItrue\fR|\fIfalse\fR .RS 4 If \fItrue\fR, all outgoing emails from this account will be signed (if a signing key is available).\& .P Default: \fIfalse\fR .P .RE \fBpgp-key-id\fR = \fI\fR .RS 4 Specify the key id to use when signing a message.\& Can be either short or long key id.\& If unset, aerc will look up the key by email.\& .P .RE \fBpgp-opportunistic-encrypt\fR = \fItrue\fR|\fIfalse\fR .RS 4 If \fItrue\fR, any outgoing email from this account will be encrypted when all recipients (including Cc and Bcc field) have a public key available in the keyring.\& .P Default: \fIfalse\fR .P .RE \fBpostpone\fR = \fI\fR .RS 4 Specifies the folder to save postponed messages to.\& .P Default: \fIDrafts\fR .P .RE \fBsend-as-utc\fR = \fItrue\fR|\fIfalse\fR .RS 4 Converts the timestamp of the Date header to UTC.\& .P Default: \fIfalse\fR .P .RE \fBsource\fR = \fI\fR .RS 4 Specifies the source for reading incoming emails on this account.\& This key is required for all accounts.\& It should be a connection string, and the specific meaning of each component varies depending on the protocol in use.\& See each protocol'\&s man page for more details: .P .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .IP \(bu 4 .\} \fBaerc-imap\fR(5) .RE .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .IP \(bu 4 .\} \fBaerc-maildir\fR(5) .RE .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .IP \(bu 4 .\} \fBaerc-notmuch\fR(5) .RE .P .RE \fBsource-cred-cmd\fR = \fI\fR .RS 4 Specifies an optional command that is run to get the source account'\&s password.\& See each protocol'\&s man page for more details.\& .P .RE \fBsignature-file\fR = \fI\fR .RS 4 Specifies the file to read in order to obtain the signature to be added to emails sent from this account.\& .P .RE \fBsignature-cmd\fR = \fI\fR .RS 4 Specifies the command to execute with \fIsh -c\fR in order to obtain the signature to be added to emails sent from this account.\& If the command fails then \fBsignature-file\fR is used instead.\& .P .RE \fBtrusted-authres\fR = \fI\fR .RS 4 Comma-separated list of trustworthy hostnames from which the Authentication Results header will be displayed.\& Entries can be regular expressions.\& If you want to trust any host (e.\&g.\& for debugging), use the wildcard \fI*\fR.\& .P .RE \fBsubject-re-pattern\fR = \fI\fR .RS 4 When replying to a message, this is the regular expression that will be used to match the prefix of the original message'\&s subject that has to be removed, to create the subject line of the new message.\& Typically, this will be used to avoid a repetition of the Re: prefix in the subject header.\& The default will match known translations for the common Re:.\& .P Default: \fI(?\&i)^((AW|RE|SV|VS|ODP|R): ?\&)+\fR .P .RE .SH SEE ALSO .P \fBaerc\fR(1) \fBaerc-config\fR(5) \fBaerc-imap\fR(5) \fBaerc-maildir\fR(5) \fBaerc-notmuch\fR(5) \fBaerc-sendmail\fR(5) \fBaerc-smtp\fR(5) .P .SH AUTHORS .P 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/.\&