On Linux, the easiest way to install Notmuch is through your distribution's
package repository. If you're installing Notmuch from a [git
-checkout](http://git.notmuchmail.org/git/notmuch) or a [source
-release](http://notmuchmail.org/releases/), please refer to the
-[INSTALL](http://git.notmuchmail.org/git/notmuch/blob/HEAD:/INSTALL) document.
+checkout](https://git.notmuchmail.org/git/notmuch) or a [source
+release](https://notmuchmail.org/releases/), please refer to the
+[INSTALL](https://git.notmuchmail.org/git/notmuch/blob/HEAD:/INSTALL) document.
## Configuration
## Converting Existing mbox to Maildir
+The [`mb2md`](http://batleth.sapienti-sat.org/projects/mb2md/) tool can be used
+to convert existing mbox files to Maildir.
+
+Beware that the source and destination directory options to `mb2md` are relative
+to the user's home directory, not relative to the current working directory.
+
## Delivering New Messages
Notmuch itself does not receive messages. There is no IMAP or POP support. You
indexing of new messages, you may want to set up a `post-new` or `post-insert`
hook to do that automatically.
-## Backing up and Restoring the Database
+## Backing Up and Restoring the Database
+
+The Notmuch database contains a search index of your messages, along with all
+the tags you've added to your messages. The search index can be regenerated by
+indexing the messages again, but the tags will be lost if the database is
+lost. (If you have `maildir.synchronize_flags` configuration option enabled,
+also some of the tags can be regenerated from maildir flags.)
+
+To create a plain-text dump of the tags, run
+
+ notmuch dump --output=dump.txt
+
+To restore the tags from the dump, run
+
+ notmuch restore --input=dump.txt
## Removing Notmuch
configuration file. The database is stored in the `.notmuch` directory under
your mail store. And your mail store is at `notmuch config get database.path`.
-Note that the database is where the tags are stored. Everything else can be
-regenerated by indexing again, but the tags will be lost when the database is
-removed. Use the `notmuch dump` command to create a backup of the tags.
+You may want to use the `notmuch dump` command to create a backup of any tags
+you've added before removing the database.