aerc-maildir(5)

aerc-maildir5

Maildir configuration for aerc(1)

Usage

aerc implements the maildir format.

Configuration

Basic Maildir configuration may be done interactively with the :new-account command.

The following maildir-specific options are available:

check-mail-cmd = <command>

Command to run in conjunction with check-mail option.

Example:

check-mail-cmd = mbsync -a

check-mail-timeout = <duration>

Timeout for the check-mail-cmd. The command will be stopped if it does not complete in this interval and an error will be displayed. Increase from the default if repeated errors occur

Default: 10s

source = maildir|maildirpp://<path>

The source indicates the path to the directory containing your maildirs rather than one maildir specifically.

The path portion of the URL following maildir:// must be either an absolute path prefixed by / or a path relative to your home directory prefixed with ~. For example:

source = maildir:///home/me/mail

source = maildir://~/mail

If your maildir is using the Maildir++ directory layout, you can use the maildirpp:// scheme instead:

source = maildirpp:///home/me/mail

source = maildirpp://~/mail

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

Authors

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

From aerc 0.22.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.