:Date:           2010-01-30

  :backlinks: top

  :class: htmlout

|vmm(1)|_ reads its configuration data from *vmm.cfg*.

  [database]

  user = me

  pass = xxxxxxxx

  [config]

  done = true

By default |vmm(1)|_ looks for *vmm.cfg* in the following directories in the

  | */root*

  | */usr/local/etc*

  | */etc*

.. _account.delete_directory:

  Determines the behavior of |vmm(1)|_ when an account is deleted

  (|userdelete|_). If this option is set to *true* the user's home directory

  will be deleted  recursively.

.. _account.directory_mode:

  Access mode for a user's home directory and all directories inside. The

  value has to be specified in decimal (base 10) notation.

  | For example: 'drwx------' -> octal 0700 -> decimal 448

.. _account.disk_usage:

  Determines whether the disk usage of a user's Maildir always should be

  summarized, using **du**\(1), and displayed with account information.

  This could be slow on large Maildirs. When you have enabled quotas,

  **vmm**'s |userinfo|_ subcomammand will also display the current quota

  usage of the account. You may also use |userinfo|_'s optional argument

  **du** or **full**, in order to display the current disk usage of an

  account's Maildir.

.. _account.imap:

  Determines whether a newly created user can log in via IMAP.

.. _account.password_length:

  Determines how many characters and/or numbers should be used for randomly

  generated passwords. Any value less than 8 will be increased to 8.

.. _account.pop3:

.. _account.random_password:

  Determines whether **vmm** should generate a random password when no

  password was given for the |useradd|_ subcommand. If this option is set to

  *false* **vmm** will prompt you to enter a password for the new account.

  You can specify the password length of generated passwords with the

  |account.password_length|_ option.

.. _account.sieve:

  Determines whether a newly created user can log in via ManageSieve.

.. _account.smtp:

  Determines whether a newly created user can log in via SMTP (SMTP AUTH).

  [account]

  delete_directory = false

  directory_mode = 448

  disk_usage = false

  random_password = true

  password_length = 10

  smtp = true

  pop3 = true

  imap = true

  sieve = true

by |vmm(1)|_.

.. _bin.dovecotpw:

  The absolute path to the dovecotpw binary. This binary is used to

  generate a password hash, if |misc.password_scheme|_ is set to one of

  'SMD5', 'SSHA', 'CRAM-MD5', 'HMAC-MD5', 'LANMAN', 'NTLM' or 'RPA'.

.. _bin.du:

  The absolute path to **du**\(1). This binary is used to summarize the disk

  usage of a user's Maildir.

.. _bin.postconf:

  The absolute path to Postfix' |postconf(1)|_. This binary is required when

  |vmm(1)|_ has to check for some Postfix settings, e.g.

  |virtual_alias_expansion_limit|_.

  [bin]

  dovecotpw = /usr/sbin/dovecotpw

  du = /usr/bin/du

  postconf = /usr/sbin/postconf

.. _config.done:

  This option is set to *false* when |vmm(1)|_ is installed for the first

  time. When you edit *vmm.cfg*, set this option to *true*. This option is

  also set to *true* when you configure |vmm(1)|_ with the command |vmm

  configure|_.

  If this option is set to *false*, |vmm(1)|_ will start in the interactive

  configurations mode.

  [config]

  done = true

.. _database.host:

  Hostname or IP address of the database server.

.. _database.name:

  Name of the database.

.. _database.pass:

  Database password.

.. _database.user:

  Name of the database user.

  [database]

  host = localhost

  user = vmm

  pass = PY_SRJ}L/0p-oOk

  name = mailsys

.. _domain.auto_postmaster:

  Determines if |vmm(1)|_ should create also a postmaster account when a new

  domain is created (|domainadd|_).

.. _domain.delete_directory:

  Specifies whether the domain directory and all user directories inside

  should be deleted when a domain is deleted (|domaindelete|_).

.. _domain.directory_mode:

  Access mode for the domain directory in decimal (base 10) notation.

  | For example: 'drwxrwx---' -> octal 0770 -> decimal 504

.. _domain.force_deletion:

  Force deletion of accounts and aliases when a domain is deleted

  (|domaindelete|_).

  [domain]

  auto_postmaster = true

  delete_directory = false

  directory_mode = 504

  force_deletion = false

.. _maildir.folders:

  A colon separated list of folder names, that should be created. If no

  folders should be created inside the Maildir, set the value of this option

  to a single colon ('**:**').

  If you want to create folders containing one or more subfolders, separate

  them with a single dot ('**.**').

.. _maildir.name:

  Default name of the Maildir folder in users home directories.

  [maildir]

  folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix

  name = Maildir

.. _imap_uft7:

.. note:: If you want to use internationalized mailbox names in the

  **folders** setting, you have to specify them in a modified version of the

  UTF-7 encoding (see :RFC:`3501`, section 5.1.3).

  Dovecot provides a useful utility for mUTF-7 <-> UTF-8 conversion:

  **imap-utf7**, it's available since Dovecot version 1.2.0.

..

imap-utf7 example::

  user@host:~$ /usr/local/libexec/dovecot/imap-utf7 -r Wysłane

  Wys&AUI-ane

  user@host:~$ /usr/local/libexec/dovecot/imap-utf7 "&AVo-mietnik"

  Śmietnik

.. _misc.base_directory:

  All domain directories will be created inside this directory.

.. _misc.password_scheme:

  Password scheme to use (see also: **dovecotpw -l**).

.. _misc.gid_mail:

  Numeric group ID of group mail (`mail_privileged_group` from

  *dovecot.conf*)

.. _misc.transport:

  Default transport for domains and accounts. For details see

  |transport(5)|_.

.. _misc.dovecot_version:

  The concatenated major and minor version number of the currently used

  Dovecot version. (see: **dovecot --version**).

  When, for example, the command **dovecot --version** prints *1.1.18*, set

  the value of this option to **11**.

  [misc]

  base_directory = /srv/mail

  password_scheme = PLAIN

  gid_mail = 8

  transport = dovecot:

  dovecot_version = 11

  | will be used when found.

  | will be used when the above file doesn't exist.

  | will be used when none of the both above mentioned files exists.

|vmm(1)|_

.. include:: ../substitute_links.rst

.. include:: ../substitute_links_5.rst