Your company here — click to reach over 10,000 unique daily visitors

lei - Man Page

local email interface


lei [Options] COMMAND


lei is a command-line tool for importing and searching email, regardless of whether it is from a personal mailbox or a public-inbox. lei supports a local, writable store built on top of public-inbox-v2-format(5) and public-inbox-extindex(1). lei-q(1) provides an interface for querying messages across the lei store and read-only local and remote "externals" (inboxes and external indices).

Warning: lei is still in its early stages and may destroy mail. Be sure to have backups of destinations lei writes to.

Available in public-inbox 1.7.0+.



Override configuration NAME to VALUE.


Change current working directory to the specified directory before running the command.  This option can be given before or after COMMAND and is accepted by all lei subcommands except lei-daemon-kill(1).


Subcommands for initializing and managing local, writable storage:

The following subcommands can be used to manage and inspect external locations:

Subcommands related to searching and inspecting messages from the lei store and configured externals are

Other subcommands include


By default storage is located at $XDG_DATA_HOME/lei/store.  The configuration for lei resides at $XDG_CONFIG_HOME/lei/config.


Errors and dianostics for interactive commands are reported to stderr.  Some errors for background tasks are emitted via syslog(3) as lei-daemon(8) for the top-level daemon, and lei/store for the lei-store-format(5) worker.


Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>

The mail archives are hosted at <https://public-inbox.org/meta/> and <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

See Also

lei-overview(7), lei-daemon(8)

Referenced By

lei-daemon(8), lei-import(1), lei-init(1), lei-mail-formats(5), lei-mail-sync-overview(7), lei-overview(7), lei-security(7), public-inbox-glossary(7), public-inbox-tuning(7).

1993-10-02 public-inbox.git public-inbox user manual