doc/web/source/_static/vmm.cfg
branchv0.7.x
changeset 718 65a29a373c19
parent 694 b1bfd4d1d9c0
child 734 8167ba72235c
equal deleted inserted replaced
717:22f61779d34f 718:65a29a373c19
     1 # This is the vmm (a virtual mail manager) configuration file.
     1 ../../../../vmm.cfg
     2 # default location: /usr/local/etc/vmm.cfg
       
     3 #
       
     4 
       
     5 #
       
     6 # Database settings
       
     7 #
       
     8 [database]
       
     9 ; Hostname or IP address of the database server (String)
       
    10 host = localhost
       
    11 ; The TCP port, on which the database server is listening for connections (Int)
       
    12 port = 5432
       
    13 ; SSL mode for the database connection (String)
       
    14 ; Possible values are:
       
    15 ;    * disabled
       
    16 ;    * allow
       
    17 ;    * prefer (default)
       
    18 ;    * require
       
    19 ;    * verify-ca (PostgreSQL >= 8.4)
       
    20 ;    * verify-full (PostgreSQL >= 8.4)
       
    21 sslmode = prefer
       
    22 ; Database user name (String)
       
    23 user = vmm
       
    24 ; Database password (String)
       
    25 pass = dbpassword
       
    26 ; Database name (String)
       
    27 name = mailsys
       
    28 
       
    29 #
       
    30 # mailbox settings
       
    31 #
       
    32 [mailbox]
       
    33 ; The mailbox format to be used for user's mailboxes. (String)
       
    34 ; Depending on the used Dovecot version there are up to 3 supported formats:
       
    35 ;    * maildir - since Dovecot v1.0.0
       
    36 ;    * mdbox   - since Dovecot v2.0.beta5
       
    37 ;    * sdbox   - since Dovecot v2.0.rc3
       
    38 format = maildir
       
    39 ; A colon separated list of mailbox names, that should be created (String)
       
    40 ; e.g.: folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfix
       
    41 folders = Drafts:Sent:Templates:Trash
       
    42 ; Name of the mailbox root directory in a user's home. (String)
       
    43 ; Usually used names (format: name):
       
    44 ;    * maildir: Maildir
       
    45 ;    * mdbox:   mdbox
       
    46 ;    * sdbox:   sdbox
       
    47 root = Maildir
       
    48 ; Set to true if the mailboxes from the folders option should be listed in
       
    49 ; the subscriptions file. (Boolean)
       
    50 subscribe = true
       
    51 
       
    52 #
       
    53 # Domain settings
       
    54 #
       
    55 [domain]
       
    56 ; Should vmm create the postmaster account when a new domain is created?
       
    57 ; (Boolean)
       
    58 auto_postmaster = true
       
    59 ; Delete domain directory recursive when deleting a domain? (Boolean)
       
    60 delete_directory = false
       
    61 ; Permissions for domain directories (Int)
       
    62 ; octal 0770 -> decimal 504
       
    63 directory_mode = 504
       
    64 ; Force deletion of accounts and aliases when deleting a domain (Boolean)
       
    65 force_deletion = false
       
    66 ;
       
    67 ; The service settings will be evaluated and applied when a domain is
       
    68 ; created. The service settings of the domain will be applied when you
       
    69 ; create a new account.
       
    70 ; Use the subcommand domainservices to modify a domain's service settings.
       
    71 ; Or userservices in order to update the service setting of an account.
       
    72 ; Allow smtp by default? (Boolean)
       
    73 smtp = true
       
    74 ; Allow pop3 by default? (Boolean)
       
    75 pop3 = true
       
    76 ; Allow imap by default? (Boolean)
       
    77 imap = true
       
    78 ; Allow managesieve by default? (Boolean)
       
    79 sieve = true
       
    80 ;
       
    81 ; The quota_* settings will be evaluated and applied when a domain is
       
    82 ; created. The domain's quota_* settings will be applied when an account
       
    83 ; is added to a domain.
       
    84 ; Use the subcommand domainquota to modify a domain's quota limits.
       
    85 ; Or userquota in order to update an account's quota limits.
       
    86 ; Quota limit in bytes. 0 means unlimited (String)
       
    87 ; The value can have one of the suffixes:
       
    88 ;    * b: bytes
       
    89 ;    * k: kilobytes
       
    90 ;    * M: megabytes
       
    91 ;    * G: gigabytes
       
    92 ; 1024 is the same as 1024b or 1k
       
    93 quota_bytes = 0
       
    94 ; Quota limit in number of messages. 0 means unlimited (Int)
       
    95 quota_messages = 0
       
    96 ;
       
    97 ; The transport setting will be evaluated and applied when a domain is
       
    98 ; created. The domain's transport setting will be applied when an account
       
    99 ; is added to a domain.
       
   100 ; Use the subcommand domaintransport to modify the transport of a domain.
       
   101 ; Or usertransport in order to update an account's transport setting.
       
   102 ;
       
   103 ; With Dovecot >= v2.0.0 it's strongly recommended that you use Dovecot's
       
   104 ; lmtp instead of the dovecot-lda.
       
   105 ;transport = lmtp:unix:private/dovecot-lmtp
       
   106 ; default transport for domains and accounts (String)
       
   107 transport = dovecot:
       
   108 
       
   109 #
       
   110 # Account settings
       
   111 #
       
   112 [account]
       
   113 ; Delete the user's home directory recursive when deleting an account? (Boolean)
       
   114 delete_directory = false
       
   115 ; Permissions for the user's home directory and mail directories (Int)
       
   116 ; octal 0700 -> decimal 448
       
   117 directory_mode = 448
       
   118 ; Display disk usage in account info by default? (Boolean)
       
   119 disk_usage = false
       
   120 ; Should vmm generate a random password when no password was given for the
       
   121 ; useradd subcommand? (Boolean)
       
   122 random_password = false
       
   123 ; How many characters to include in the generated passwords? (Int)
       
   124 password_length = 8
       
   125 
       
   126 #
       
   127 # external binaries
       
   128 #
       
   129 [bin]
       
   130 ; location of dovecotpw (Dovecot v1) or doveadm (Dovecot v2) (String)
       
   131 dovecotpw = /usr/sbin/dovecotpw
       
   132 ; location of disk usage (String)
       
   133 du = /usr/bin/du
       
   134 ; location of postconf (String)
       
   135 postconf = /usr/sbin/postconf
       
   136 
       
   137 #
       
   138 # misc settings
       
   139 #
       
   140 [misc]
       
   141 ; The base directory for all domains/accounts (String)
       
   142 base_directory = /srv/mail
       
   143 ; Number of encryption rounds for the password_scheme BLF-CRYPT (Int)
       
   144 crypt_blowfish_rounds = 5
       
   145 ; Number of encryption rounds for the password_scheme SHA256-CRYPT (Int)
       
   146 crypt_sha256_rounds = 5000
       
   147 ; Number of encryption rounds for the password_scheme SHA512-CRYPT (Int)
       
   148 crypt_sha512_rounds = 5000
       
   149 ; the version number from `dovecot --version` (String)
       
   150 ; e.g. 1.2.17, 2.0.21, 2.1.9 or 2.2.beta1
       
   151 dovecot_version = 2.1.9
       
   152 ; Password scheme to use (see also: ´vmm listpwschemes`) (String)
       
   153 password_scheme = CRAM-MD5
       
   154