8c706a77db
When re-initializing the store, automatically write the labels to a file in mu's cache, so user can later import them.
4.7 KiB
MU INIT
NAME
mu-init - initialize the mu message database
SYNOPSIS
mu [_COMMON-OPTIONS_] init [_OPTIONS_]
DESCRIPTION
mu init is the subcommand for setting up the mu message database. After mu init has completed, you can run mu index.
INIT OPTIONS
-m, –maildir maildir
Use maildir as the root-maildir.
By default, mu uses the MAILDIR environment to find the root-maildir. If it is
not set, it uses ~/Maildir if it is an existing directory. If neither of those
can be used, the –maildir option is required; it must be an absolute path (but
~/ expansion is performed).
–personal-address email-address-or-regex
–my-address email-address-or-regex (alias)
Specifies that some e-mail address is a personal address. The option can be used multiple times, to specify all your addresses.
Any message in which at least one of the contact fields matches a personal address, is considered a `personal' message; this can then be used for filtering in and mu4e, e.g. to filter-out mailing list messages.
email-address-or-regex can be either a plain e-mail address (such as
foo@example.com), or a basic PCRE regular-expression (see
for details), wrapped in / (such as /foo-.*@example\\.com/). Depending on your
shell, the argument may need to be quoted.
A note of warning for mu4e users: any regular-expressions used with
--with-address are also used by mu4e. Unfortunately, PCRE regular expressions
are not generally compatible with Emacs regular expressions. For instance,
(foo|bar) in PCRE syntax has \(foo\|bar\) as its Emacs equivalent.
The good news is that mu4e can automatically translate the regular-expressions, if you allow it to, by installing the pcre2el Elisp package. See the mu4e documentation for further details.
–ignored-address email-address-or-regex
Specifies that some e-mail address is to be ignored from the contacts-cache (the option can be used multiple times). Such addresses then cannot be found with or in the Mu4e contacts cache.
my-email-address can be either a plain e-mail address or a regexp, just like for the –personal-address option.
–max-message-size size
Specifies the maximum size for an e-mail message. Usually, the default of 100000000 bytes should be fine.
–batch-size size
The number of changes after which they are committed to the database; decreasing the value reduces the memory requirements, at the cost of make indexing substantially slower. Usually, the default of 250000 should be fine.
Batch-size 0 is interpreted as `use the default'.
–support-ngrams
Whether to enable support for using ngrams in indexing and query parsing; this can be useful for languages without explicit word breaks, such as Chinese/Japanese/Korean. See NGRAM SUPPORT below for details.
–reinit
Reinitialize the database from an earlier version; that is, create a new empty database with the existing settings. This cannot be combined with the other init options.
When you have labels defined for messages in your database, mu automatically exports those to file for importing later. See RESTORING LABELS below.
NGRAM SUPPORT
mu's underlying Xapian database supports `ngrams', which improve searching for languages/scripts that do not have explicit word breaks, such as Chinese, Japanese and Korean. It is fairly intrusive, and influences both indexing and query-parsing; it is not enabled by default, and is recommended only if you need to search for messages written in such languages.
When enabled, mu automatically uses ngrams automatically. Xapian environment variables such as XAPIAN_CJK_NGRAM are ignored.
RESTORING LABELS
When you have any labels defined for your database, mu automatically exports
those to a file in the mu cache directory; you see this in the --init output.
$ mu init --reinit exported labels to: /home/user/.cache/mu/mu-export-2025-08-16-13:43:27.txt
You can restore those labels after re-indexing, e.g.,
$ mu label import /home/user/.cache/mu/mu-export-2025-08-16-13:43:27.txt
Please see for further details.
EXAMPLE
$ mu init --maildir=~/Maildir --my-address=alice@example.com --my-address=bob@example.com --ignored-address='/.*reply.*/'
SEE ALSO
, , , ,