sup-add - Man Page

add a source to the Sup source list


sup-add [options] [source uri...]


Add one ore more sources to the Sup source list

For mbox files on local disk, use the form:

mbox:<path to mbox file>, or

mbox://<path to mbox file>

For Maildir folders, use the form:

maildir:<path to Maildir directory>; or

maildir://<path to Maildir directory>


-a,  --archive

Automatically archive all new messages from thesesources.

-u,  --unusual

Do not automatically poll these sources for new messages.

-l STRING, --labels STRING

A comma-separated set of labels to apply to all messages from this source

-f,  --force-new

Create a new account for this source, even if one already exists

-o STRING, --force-account STRING

Reuse previously defined account user@hostname

-v,  --version

Print version and exit

-h,  --help

Show help message



Configuration file for Sup mail sources

See Also

sup(1), sup-config(1)

Reporting Bugs

You are welcome to submit bug reports to the Sup issue tracker, located at


Contact Information

The Sup web page:


Code repository:


Sup Wiki:


Sup IRC channel:

#sup @

Mailing list:

Archives: <>


Sup was originally written by William Morgan <> and is now developed and maintained by the Sup developers.

Referenced By

sup(1), sup-config(1), sup-psych-ify-config-files(1), sup-recover-sources(1), sup-sync(1), sup-sync-back-maildir(1), sup-tweak-labels(1).

April 9, 2012 Sup User Manual