DOVEADM-MOUNT(1)                             Dovecot                             DOVEADM-MOUNT(1)



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  wild‐
       cards  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@dove‐
       cot.org>.   Information  about  reporting  bugs is available at: http://dovecot.org/bugre‐
       port.html

SEE ALSO
       doveadm(1)



Dovecot v2.2                                2012-02-16                           DOVEADM-MOUNT(1)