Note that many of these configuration options are written for you,
such as source and outgoing, when you run the account
configuration wizard (:new-account).
archive = <folder>
Specifies a folder to use as the destination of the
:archive command.
Default: Archive
check-mail = <duration>
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
check-mail-cmd in
conjunction with this option. See
aerc-maildir(5) and
aerc-notmuch(5) for more information.
Setting this option to 0 will disable check-mail
Example:
check-mail = 5m
Default: 0
copy-to = <folder>
Specifies a folder to copy sent mails to, usually
Sent.
default = <folder>
Specifies the default folder to open in the message list
when aerc configures this account.
Default: INBOX
folders = <folder1,folder2,folder3...>
Specifies the comma separated list of folders to display
in the sidebar. Names prefixed with
~ are interpreted as regular
expressions.
By default, all folders are displayed.
folders-exclude =
<folder1,folder2,folder3...>
Specifies the comma separated list of folders to exclude
from the sidebar. Names prefixed with
~ are interpreted as regular
expressions. Note that this overrides anything from
folders.
By default, no folders are excluded.
enable-folders-sort = true|false
If
true, folders are sorted, first by specified
folders (see
folders-sort), then alphabetically.
Default: true
folders-sort =
<folder1,folder2,folder3...>
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.
from = <address>
The default value to use for the From header in new
emails. This should be an RFC 5322-compatible string, such as Your Name
<you@example.org>.
aliases = <address1,address2,address3...>
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
aerc-sendmail(5) in combination with
msmtp(1)
and
--read-envelope-from.
outgoing = <uri>
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:
outgoing-cred-cmd = <command>
Specifies an optional command that is run to get the
outgoing account's password. See each protocol's man page for more
details.
outgoing-cred-cmd-cache = true|false
By default, the credentials returned by the command will
be cached until aerc is shut down. If set to
false,
outgoing-cred-cmd will be executed every time an email is to be sent.
Default: true
pgp-auto-sign = true|false
If
true, all outgoing emails from this account
will be signed (if a signing key is available).
Default: false
pgp-key-id = <key-id>
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.
pgp-opportunistic-encrypt = true|false
If
true, 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.
Default: false
postpone = <folder>
Specifies the folder to save postponed messages to.
Default: Drafts
send-as-utc = true|false
Converts the timestamp of the Date header to UTC.
Default: false
source = <uri>
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:
source-cred-cmd = <command>
Specifies an optional command that is run to get the
source account's password. See each protocol's man page for more
details.
signature-file = <path>
Specifies the file to read in order to obtain the
signature to be added to emails sent from this account.
signature-cmd = <command>
Specifies the command to execute with sh -c in
order to obtain the signature to be added to emails sent from this account. If
the command fails then signature-file is used instead.
trusted-authres = <host1,host2,host3...>
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 *.
subject-re-pattern = <regexp>
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:.
Default: (?i)^((AW|RE|SV|VS|ODP|R): ?)+