1 .\" $Id$ |
|
2 .TH vmm.cfg 5 "30. April 2008" "Pascal Volk" |
|
3 .SH NAME |
|
4 vmm.cfg \- configuration file for vmm |
|
5 .SH SYNOPSIS |
|
6 /usr/local/etc/vmm.cfg |
|
7 .SH DESCRIPTION |
|
8 \fBvmm\fR(1) reads configuration data from \fI/usr/local/etc/vmm.cfg\fP. |
|
9 .br |
|
10 The configuration file is split in multiple sections. A section starts with the |
|
11 section name, enclosed in square brackets '[' and ']' (e.g. \fB[database]\fP), |
|
12 followed by \'option=value' pairs (e.g. \fBhost = 127.0.0.1\fP). |
|
13 .br |
|
14 Whitespace around the '=' and at the end of a value is ignored. |
|
15 .PP |
|
16 Empty lines and lines starting with '#' or ';' will be ignored. |
|
17 .PP |
|
18 Each value uses one of the following data types: |
|
19 .IP \(bu |
|
20 .I Boolean |
|
21 to indicate if something is enabled/activated (true) or disabled/deactivated |
|
22 (false). |
|
23 .br |
|
24 Accepted values for \fBtrue\fP are: \fB1\fP, \fByes\fP, \fBtrue\fP and |
|
25 \fBon\fP. |
|
26 .br |
|
27 Accepted values for \fBfalse\fP are: \fB0\fP, \fBno\fP, \fBfalse\fP and |
|
28 \fBoff\fP. |
|
29 .IP \(bu |
|
30 .I Int |
|
31 a integer number, written without a fractional or decimal component. For example |
|
32 \fB1\fP, \fB50\fP or \fB321\fP are integers. |
|
33 .IP \(bu |
|
34 .I String |
|
35 a sequence of characters and numbers. For example '\fBword\fP', '\fBhello |
|
36 world\fP', or '\fB/usr/bin/strings\fP' |
|
37 .\" ----- |
|
38 .SH DATABASE SECTION |
|
39 The \fBdatabase\fP section is used to specify some options required to |
|
40 connect to the database. |
|
41 .TP |
|
42 \fBhost\fP (\fIString\fP) |
|
43 Hostname or IP address of the database server. |
|
44 .TP |
|
45 \fBuser\fP (\fIString\fP) |
|
46 Name of the database user. |
|
47 .TP |
|
48 \fBpass\fP (\fIString\fP) |
|
49 Database password |
|
50 .TP |
|
51 \fBname\fP (\fIString\fP) |
|
52 Name of the database. |
|
53 .TP |
|
54 \fBExample\fP: |
|
55 [database] |
|
56 .br |
|
57 host = localhost |
|
58 .br |
|
59 user = vmm |
|
60 .br |
|
61 pass = T~_:L4OYyl]TU?) |
|
62 .br |
|
63 name = mailsys |
|
64 .\" ----- |
|
65 .SH MAILDIR SECTION |
|
66 The \fBmaildir\fP section is used to specify some options for the Maildirs. |
|
67 .TP |
|
68 \fBfolder\fP (\fIString\fP) |
|
69 Default name of the maildir folder in users home directory. |
|
70 .TP |
|
71 \fBmode\fP (\fIInt\fP) |
|
72 Access mode for the maildir in decimal (base 10) notation. For example: |
|
73 \'drwx------' -> octal 0700 -> decimal 448 |
|
74 .TP |
|
75 \fBdiskusage\fP (\fIBoolean\fP) |
|
76 Decides if the disk usage of users maildir always should be summarized an |
|
77 displayed with account information. |
|
78 .TP |
|
79 \fBdelete\fP (\fIBoolean\fP) |
|
80 Decides if the maildir should be deleted recursive when the account is deleted. |
|
81 .TP |
|
82 \fBExample\fP: |
|
83 [maildir] |
|
84 .br |
|
85 folder = Maildir |
|
86 .br |
|
87 mode = 448 |
|
88 .br |
|
89 diskusage = false |
|
90 .br |
|
91 delete = false |
|
92 .\" ----- |
|
93 .SH SERVICES SECTION |
|
94 The \fBservices\fP section is used to specify the default restrictions for |
|
95 all accounts. |
|
96 .TP |
|
97 \fBsmtp\fP (\fIBoolean\fP) |
|
98 Decides if users can login via smtp by default. |
|
99 .TP |
|
100 \fBpop3\fP (\fIBoolean\fP) |
|
101 Decides if users can login via pop3 by default. |
|
102 .TP |
|
103 \fBimap\fP (\fIBoolean\fP) |
|
104 Decides if users can login via imap by default. |
|
105 .TP |
|
106 \fBmanagesieve\fP (\fIBoolean\fP) |
|
107 Decides if users can login via managesieve by default. |
|
108 .TP |
|
109 \fBExample\fP: |
|
110 [services] |
|
111 .br |
|
112 smtp = true |
|
113 .br |
|
114 pop3 = true |
|
115 .br |
|
116 imap = false |
|
117 .br |
|
118 managesieve = false |
|
119 .\" ----- |
|
120 .SH DOMDIR SECTION |
|
121 The \fBdomdir\fP section is used to specify options for the directories of the |
|
122 domains. |
|
123 .TP |
|
124 \fBbase\fP (\fIString\fP) |
|
125 All domain directories will be created inside this directory. |
|
126 .TP |
|
127 \fBmode\fP (\fIInt\fP) |
|
128 Access mode for the domain directory in decimal (base 10) notation. For |
|
129 example: 'drwxrwx---' -> octal 0770 -> decimal 504 |
|
130 .TP |
|
131 \fBdelete\fP (\fIBoolean\fP) |
|
132 Decides if the domain directory and all user directories inside should be |
|
133 deleted when a domain is deleted. |
|
134 .TP |
|
135 \fBExample\fP: |
|
136 [domdir] |
|
137 .br |
|
138 base = /home/mail |
|
139 .br |
|
140 mode = 504 |
|
141 .br |
|
142 delete = false |
|
143 .\" ----- |
|
144 .SH BIN SECTION |
|
145 The \fBbin\fP section is used to specify some paths to some binaries required |
|
146 by \fBvmm\fP. |
|
147 .TP |
|
148 \fBdovecotpw\fP (\fIString\fP) |
|
149 The absolute path to the dovecotpw binary. This binary is used to generate a |
|
150 password hash, if the \fIpasswdscheme\fP is one of 'SMD5', 'SSHA', 'CRAM-MD5', |
|
151 \'HMAC-MD5', 'LANMAN', 'NTLM' or 'RPA'. |
|
152 .TP |
|
153 \fBdu\fP (\fIString\fP) |
|
154 The absolute path to \fBdu\fR(1). This binary is used to summarize the disk |
|
155 usage of a maildir. |
|
156 .TP |
|
157 \fBExample\fP: |
|
158 [bin] |
|
159 .br |
|
160 dovecotpw = /usr/sbin/dovecotpw |
|
161 .br |
|
162 du = /usr/bin/du |
|
163 .\" ----- |
|
164 .SH MISC SECTION |
|
165 The \fBmisc\fP section is used to define miscellaneous settings. |
|
166 .TP |
|
167 \fBpasswdscheme\fP (\fIString\fP) |
|
168 Password scheme to use (see also: dovecotpw -l) |
|
169 .TP |
|
170 \fBgid_mail\fP (\fIInt\fP) |
|
171 Numeric group ID of group mail (mail_privileged_group from dovecot.conf) |
|
172 .TP |
|
173 \fBforcedel\fP (\fIBoolean\fP) |
|
174 Force deletion of accounts and aliases when a domain is deleted. |
|
175 .TP |
|
176 \fBtransport\fP (\fIString\fP) |
|
177 Default transport for domains and accounts. |
|
178 .TP |
|
179 \fBExample\fP: |
|
180 [misc] |
|
181 .br |
|
182 passwdscheme = CRAM-MD5 |
|
183 .br |
|
184 gid_mail = 8 |
|
185 .br |
|
186 forcedel = false |
|
187 .br |
|
188 transport = dovecot: |
|
189 .\" ----- |
|
190 .SH CONFIG SECTION |
|
191 The \fBconfig\fP section is a internal used control section. |
|
192 .TP |
|
193 \fBdone\fP (\fIBoolean\fP) |
|
194 This option is set to \fIfalse\fP when \fBvmm\fP is installed for the first |
|
195 time. When you edit \fIvmm.cfg\fP, set this option to \fItrue\fP. This option is |
|
196 also set to \fItrue\fP when you configure vmm with the command \fBvmm |
|
197 configure\fP. |
|
198 .br |
|
199 If this option is set to \fIfalse\fP, \fBvmm\fP will start in the interactive |
|
200 configurations mode. |
|
201 .TP |
|
202 \fBExample\fP: |
|
203 [config] |
|
204 .br |
|
205 done = true |
|
206 .\" ----- |
|
207 .SH FILES |
|
208 /usr/local/etc/vmm.cfg |
|
209 .SH SEE ALSO |
|
210 vmm(1), command line tool to manage email domains/accounts/aliases |
|
211 .SH AUTHOR |
|
212 \fBvmm\fP and its man pages were written by Pascal Volk |
|
213 <\fIp.volk@veb-it.de\fP> and are licensed under the terms of the BSD License. |
|