|
1 .\" $Id$ |
|
2 .TH vmm.cfg 5 "28. 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 form \fI/usr/local/etc/vmm.cfg\fP. |
|
9 .br |
|
10 The configuration file is split in multiple sections. Sections begins 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). Accepted values for \fBtrue\fP are: \fB1\fP, \fByes\fP, \fBtrue\fP and |
|
23 \fBon\fP. |
|
24 .br |
|
25 Accepted values for \fBfalse\fP are: \fB0\fP, \fBno\fP, \fBfalse\fP and |
|
26 \fBoff\fP. |
|
27 .IP \(bu |
|
28 .I Int |
|
29 a integer number, written without a fractional or decimal component. For example |
|
30 \fB1\fP, \fB50\fP or \fB321\fP are integers. |
|
31 .IP \(bu |
|
32 .I String |
|
33 a sequence of characters and numbers. For example '\fBword\fP', '\fBhello |
|
34 world\fP', or '\fB/usr/bin/strings\fP' |
|
35 .\" ----- |
|
36 .SH DATABASE SECTION |
|
37 This section contains options required for the database connection. |
|
38 .TP |
|
39 \fBhost\fP (\fIString\fP) |
|
40 Hostname or IP address of the database server. |
|
41 .TP |
|
42 \fBuser\fP (\fIString\fP) |
|
43 Name of the database user. |
|
44 .TP |
|
45 \fBpass\fP (\fIString\fP) |
|
46 Database password |
|
47 .TP |
|
48 \fBname\fP (\fIString\fP) |
|
49 Name of the database. |
|
50 .TP |
|
51 \fBExample\fP: |
|
52 [database] |
|
53 .br |
|
54 host = localhost |
|
55 .br |
|
56 user = vmm |
|
57 .br |
|
58 pass = T~_:L4OYyl]TU?) |
|
59 .br |
|
60 name = mailsys |
|
61 .\" ----- |
|
62 .SH MAILDIR SECTION |
|
63 This section defines some options for the Maildirs. |
|
64 .TP |
|
65 \fBfolder\fP (\fIString\fP) |
|
66 Default name of the maildir folder in users home directory. |
|
67 .TP |
|
68 \fBmode\fP (\fIInt\fP) |
|
69 Access mode for the maildir in decimal (base 10) notation. For example: |
|
70 \'drwx------' -> octal 0700 -> decimal 448 |
|
71 .TP |
|
72 \fBdiskusage\fP (\fIBoolean\fP) |
|
73 Decides if the disk usage of users maildir always should be summarized an |
|
74 displayed with account information. |
|
75 .TP |
|
76 \fBdelete\fP (\fIBoolean\fP) |
|
77 Decides if the maildir should be deleted recursive when the account is deleted. |
|
78 .TP |
|
79 \fBExample\fP: |
|
80 [maildir] |
|
81 .br |
|
82 folder = Maildir |
|
83 .br |
|
84 mode = 448 |
|
85 .br |
|
86 diskusage = false |
|
87 .br |
|
88 delete = false |
|
89 .\" ----- |
|
90 .SH SERVICES SECTION |
|
91 This section specifies the default restrictions for each account. |
|
92 .TP |
|
93 \fBsmtp\fP (\fIBoolean\fP) |
|
94 Decides if users can login via smtp by default. |
|
95 .TP |
|
96 \fBpop3\fP (\fIBoolean\fP) |
|
97 Decides if users can login via pop3 by default. |
|
98 .TP |
|
99 \fBimap\fP (\fIBoolean\fP) |
|
100 Decides if users can login via imap by default. |
|
101 .TP |
|
102 \fBmanagesieve\fP (\fIBoolean\fP) |
|
103 Decides if users can login via managesieve by default. |
|
104 .TP |
|
105 \fBExample\fP: |
|
106 [services] |
|
107 .br |
|
108 smtp = true |
|
109 .br |
|
110 pop3 = true |
|
111 .br |
|
112 imap = false |
|
113 .br |
|
114 managesieve = false |
|
115 .\" ----- |
|
116 .SH DOMDIR SECTION |
|
117 This section defines some options for the directories of the domains. |
|
118 .TP |
|
119 \fBbase\fP (\fIString\fP) |
|
120 All domain directories will be created inside this directory. |
|
121 .TP |
|
122 \fBmode\fP (\fIInt\fP) |
|
123 Access mode for the domain directory in decimal (base 10) notation. For |
|
124 example: 'drwxrwx---' -> octal 0770 -> decimal 504 |
|
125 .TP |
|
126 \fBdelete\fP (\fIBoolean\fP) |
|
127 Decides if the domain directory and all user directories inside should be |
|
128 deleted when a domain is deleted. |
|
129 .TP |
|
130 \fBExample\fP: |
|
131 [domdir] |
|
132 .br |
|
133 base = /home/mail |
|
134 .br |
|
135 mode = 504 |
|
136 .br |
|
137 delete = false |
|
138 .\" ----- |
|
139 .SH BIN SECTION |
|
140 This section contains some paths to some binaries. |
|
141 .TP |
|
142 \fBdovecotpw\fP (\fIString\fP) |
|
143 The absolute path to the dovecotpw binary. This binary is used to generate a |
|
144 password hash, if the \fIpasswdscheme\fP is one of 'SMD5', 'SSHA', 'CRAM-MD5', |
|
145 \'HMAC-MD5', 'LANMAN', 'NTLM' or 'RPA'. |
|
146 .TP |
|
147 \fBdu\fP (\fIString\fP) |
|
148 The absolute path to \fBdu\fR(1). This binary is used to summarize the disk |
|
149 usage of a maildir. |
|
150 .TP |
|
151 \fBExample\fP: |
|
152 [bin] |
|
153 .br |
|
154 dovecotpw = /usr/sbin/dovecotpw |
|
155 .br |
|
156 du = /usr/bin/du |
|
157 .\" ----- |
|
158 .SH MISC SECTION |
|
159 This sections defines miscellaneous settings. |
|
160 .TP |
|
161 \fBpasswdscheme\fP (\fIString\fP) |
|
162 Password scheme to use (see also: dovecotpw -l) |
|
163 .TP |
|
164 \fBgid_mail\fP (\fIInt\fP) |
|
165 Numeric group ID of group mail (mail_privileged_group from dovecot.conf) |
|
166 .TP |
|
167 \fBforcedel\fP (\fIBoolean\fP) |
|
168 Force deletion of accounts and aliases when a domain is deleted. |
|
169 .TP |
|
170 \fBtransport\fP (\fIString\fP) |
|
171 Default transport for domains and accounts. |
|
172 .TP |
|
173 \fBExample\fP: |
|
174 [misc] |
|
175 .br |
|
176 passwdscheme = CRAM-MD5 |
|
177 .br |
|
178 gid_mail = 8 |
|
179 .br |
|
180 forcedel = false |
|
181 .br |
|
182 transport = dovecot: |
|
183 .\" ----- |
|
184 .SH CONFIG SECTION |
|
185 This section is a internal control section. |
|
186 .TP |
|
187 \fBdone\fP (\fIBoolean\fP) |
|
188 This option is set to \fIfalse\fP when \fBvmm\fP is installed for the first |
|
189 time. When you edit \fIvmm.cfg\fP, set this option to \fItrue\fP. This option is |
|
190 also set to \fItrue\fP when you configure vmm with the command \fBvmm |
|
191 configure\fP. |
|
192 .br |
|
193 If this option is set to \fIfalse\fP, \fBvmm\fP will start in the interactive |
|
194 configurations mode. |
|
195 .TP |
|
196 \fBExample\fP: |
|
197 [config] |
|
198 .br |
|
199 done = true |