NAME

       doveadm-mount - Manage the list of mountpoints where mails are stored

SYNOPSIS

       doveadm [-Dv] [-f formatter] mount command [arguments]

DESCRIPTION

       The  doveadm  mount commands can be used to manage the list of mountpoints where mails are
       stored.  This is used mainly for better error handling when a mountpoint isn't mounted for
       some reason:

       *   If  a  mail  directory  doesn't  exist,  it's autocreated.  If the user's mails aren't
           mounted and filesystem permissions still allow the autocreation, the user will see  an
           empty mailbox and later will have to redownload all mails.  If the mountpoint is known
           to be unmounted, Dovecot will simply fail opening any mailboxes.

       *   If dbox alternate storage isn't mounted and a mail in it is attempted to be  accessed,
           Dovecot  normally  rebuilds  the indexes and notices that all the mails in alt storage
           are expunged.  When the alt storage is  mounted  back  and  even  if  index  is  again
           rebuilt,  the mails won't necessarily become visible anymore for IMAP clients.  If the
           mountpoint is known to be unmounted, Dovecot won't rebuild indexes and lose the mails.

       Dovecot automatically adds mountpoints to this list at startup.  If you don't want some of
       the mountpoints added, you can add a wildcard ignore for it.

OPTIONS

       Global doveadm(1) options:

       -D     Enables verbosity and debug messages.

       -f formatter
              Specifies the formatter for formatting the output.  Supported formatters are:

              flow   prints each line with key=value pairs.

              pager  prints  each key: value pair on its own line and separates records with form
                     feed character (^L).

              tab    prints a table header followed by tab separated value lines.

              table  prints a table header followed by adjusted value lines.

       -v     Enables verbosity, including progress counter.

ARGUMENTS

       path   The directory name of a mountpoint

       state  The state of a mountpoint.  Either online or ignore.

COMMANDS

   mount add
       doveadm mount add [path [state]]

       If this command is run without any parameters, doveadm detects all missing mountpoints and
       adds them (the same way as when Dovecot does at startup).

       When  a  mountpoint path is given, it's added as a mountpoint.  The state can currently be
       either "online" (default) or "ignore".  The  ignore  state  is  mainly  useful  with  path
       wildcards  to  add  mountpoints that you never want Dovecot to automatically add, such as:
       doveadm mount add '/mnt/*' ignore

   mount list
       doveadm [-Dv ] [-f formatter] mount list

       This command lists the mountpoints known to Dovecot and their state.

   mount remove
       doveadm mount remove path

       This command removes the specified path from the mountpoint list.

REPORTING BUGS

       Report   bugs,   including   doveconf   -n   output,   to   the   Dovecot   Mailing   List
       <dovecot@dovecot.org>.     Information    about    reporting   bugs   is   available   at:
       http://dovecot.org/bugreport.html

SEE ALSO

       doveadm(1)