.\" Man page generated from reStructeredText...THVMM.CFG5"2010-01-18""vmm-0.6.0""vmm Manual".SHNAMEvmm.cfg \- configuration file for vmm..nrrst2man-indent-level0..de1rstReportMargin\\$1 \\n[an-margin]level \\n[rst2man-indent-level]level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]-\\n[rst2man-indent0]\\n[rst2man-indent1]\\n[rst2man-indent2]...de1INDENT.\" .rstReportMargin pre:.RS\\$1.nrrst2man-indent\\n[rst2man-indent-level]\\n[an-margin].nrrst2man-indent-level+1.\" .rstReportMargin post:...deUNINDENT.RE.\" indent \\n[an-margin].\" old: \\n[rst2man-indent\\n[rst2man-indent-level]].nrrst2man-indent-level-1.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]].in\\n[rst2man-indent\\n[rst2man-indent-level]]u...SHSYNOPSIS.spvmm.cfg.SHDESCRIPTION.sp\fBvmm\fP(1) reads its configuration data from \fIvmm.cfg\fP..spThe configuration file is split into multiple sections. A section starts withthe section name, enclosed in square brackets \(aq\fB[\fP\(aq and \(aq\fB]\fP\(aq, followedby \(aq\fIoption\fP = \fIvalue\fP\(aq pairs:.sp.nf.ftC[database]host = 127.0.0.1.ftP.fi.spWhitespace around the \(aq=\(aq and at the end of a value is ignored..spEmpty lines and lines starting with \(aq#\(aq or \(aq;\(aq will be ignored..spEach value uses one of the following data types:.INDENT0.0.IP\(bu2.\fIBoolean\fP to indicate if something is enabled/activated (true) ordisabled/deactivated (false)..nfAccepted values for \fItrue\fP are: \fB1\fP, \fByes\fP, \fBtrue\fP and \fBon\fP.Accepted values for \fIfalse\fP are: \fB0\fP, \fBno\fP, \fBfalse\fP and \fBoff\fP..fi.sp.IP\(bu2.\fIInt\fP an integer number, written without a fractional or decimal component..nfFor example \fB1\fP, \fB50\fP or \fB321\fP are integers..fi.sp.IP\(bu2.\fIString\fP a sequence of characters and numbers..nfFor example \(aq\fBword\fP\(aq, \(aq\fBhello world\fP\(aq or \(aq\fB/usr/bin/strings\fP\(aq.fi.sp.UNINDENT.SSSEARCHORDER.spBy default \fBvmm\fP(1) looks for \fIvmm.cfg\fP in the following directories in theorder listed:.INDENT0.0.INDENT3.5.nf\fI/root\fP\fI/usr/local/etc\fP\fI/etc\fP.fi.sp.UNINDENT.UNINDENT.spThe first configuration file found will be used..SHSECTIONS.spThis section describes all sections and their options of the \fIvmm.cfg\fP..SSACCOUNT.spThe options in the section \fBaccount\fP are used to specify user accountrelated settings..INDENT0.0.TP.B\fCdelete_directory\fP\fIBoolean\fP.spDetermines the behavior of \fBvmm\fP(1) when an account is deleted. Ifthis option is set to \fItrue\fP the user\(aqs home directory will be deletedrecursively..TP.B\fCdirectory_mode\fP\fIInt\fP.spAccess mode for a user\(aqs home directory and all directories inside.The value has to be specified in decimal (base 10) notation..nfFor example: \(aqdrwx\-\-\-\-\-\-\(aq\-> octal 0700 \-> decimal 448.fi.sp.TP.B\fCdisk_usage\fP\fIBoolean\fP.spDetermines whether the disk usage of a user\(aqs Maildir always should besummarized, using \fBdu\fP(1), and displayed with account information..spThis could be slow on large Maildirs. When you have enabled quotas,\fBvmm\fP\(aqs \fBuserinfo\fP subcomammand will also display the current quotausage of the account. You may also use \fBuserinfo\fP\(aqs optional argument\fBdu\fP or \fBfull\fP, in order to display the current disk usage of anaccount..TP.B\fCimap\fP\fIBoolean\fP.spDetermines whether a newly created user can log in via IMAP..TP.B\fCpassword_length\fP\fIInt\fP.spDetermines how many characters and/or numbers should be used for randomgenerated passwords. Any value less than 8 will be increased to 8..TP.B\fCpop3\fP\fIBoolean\fP.spDetermines whether a newly created user can log in via POP3..TP.B\fCrandom_password\fP\fIBoolean\fP.spDetermines whether \fBvmm\fP should generate a random password when nopassword was given for the \fBuseradd\fP subcommand. If this option isset to \fIfalse\fP\fBvmm\fP will prompt you to enter a password for the newaccount..spYou can specify the password length of generated passwords with the\fBpassword_length\fP option..TP.B\fCsieve\fP\fIBoolean\fP.spDetermines whether a newly created user can log in via ManageSieve..TP.B\fCsmtp\fP\fIBoolean\fP.spDetermines whether a newly created user can log in via SMTP (SMTP AUTH)..UNINDENT.spExample:.sp.nf.ftC[account]delete_directory = falsedirectory_mode = 448disk_usage = falserandom_password = truepassword_length = 10smtp = truepop3 = trueimap = truesieve = true.ftP.fi.SSBIN.spThe \fBbin\fP section is used to specify some paths to some binaries requiredby \fBvmm\fP(1)..INDENT0.0.TP.B\fCdovecotpw\fP\fIString\fP.spThe absolute path to the dovecotpw binary. This binary is used togenerate a password hash, if \fBmisc.password_scheme\fP is set to one of\(aqSMD5\(aq, \(aqSSHA\(aq, \(aqCRAM\-MD5\(aq, \(aqHMAC\-MD5\(aq, \(aqLANMAN\(aq, \(aqNTLM\(aq or \(aqRPA\(aq..TP.B\fCdu\fP\fIString\fP.spThe absolute path to \fBdu\fP(1). This binary is used to summarize thedisk usage of a user\(aqs Maildir..TP.B\fCpostconf\fP\fIString\fP.spThe absolute path to Postfix\(aq\fBpostconf\fP(1). This binary is requiredwhen \fBvmm\fP(1) has to check for some Postfix settings, e.g.\fIvirtual_alias_expansion_limit\fP..UNINDENT.spExample:.sp.nf.ftC[bin]dovecotpw = /usr/sbin/dovecotpwdu = /usr/bin/dupostconf = /usr/sbin/postconf.ftP.fi.SSCONFIG.spThe \fBconfig\fP section is an internal used control section..INDENT0.0.TP.B\fCdone\fP\fIBoolean\fP.spThis option is set to \fIfalse\fP when \fBvmm\fP(1) is installed for the firsttime. When you edit \fIvmm.cfg\fP, set this option to \fItrue\fP. This option isalso set to \fItrue\fP when you configure \fBvmm\fP(1) with the command \fBvmmconfigure\fP..spIf this option is set to \fIfalse\fP, \fBvmm\fP(1) will start in theinteractive configurations mode..UNINDENT.spExample:.sp.nf.ftC[config]done = true.ftP.fi.SSDATABASE.spThe \fBdatabase\fP section is used to specify some options required toconnect to the database..INDENT0.0.TP.B\fChost\fP\fIString\fP.spHostname or IP address of the database server..TP.B\fCname\fP\fIString\fP.spName of the database..TP.B\fCpass\fP\fIString\fP.spDatabase password..TP.B\fCuser\fP\fIString\fP.spName of the database user..UNINDENT.spExample:.sp.nf.ftC[database]host = localhostuser = vmmpass = PY_SRJ}L/0p\-oOkname = mailsys.ftP.fi.SSDOMAIN.spThe \fBdomain\fP section specifies some domain related settings..INDENT0.0.TP.B\fCauto_postmaster\fP\fIBoolean\fP.spDetermines if \fBvmm\fP(1) should create also a postmaster account when anew domain is created..TP.B\fCdelete_directory\fP\fIBoolean\fP.spSpecifies whether the domain directory and all user directories insideshould be deleted when a domain is deleted..TP.B\fCdirectory_mode\fP\fIInt\fP.spAccess mode for the domain directory in decimal (base 10) notation..nfFor example: \(aqdrwxrwx\-\-\-\(aq\-> octal 0770 \-> decimal 504.fi.sp.TP.B\fCforce_deletion\fP\fIBoolean\fP.spForce deletion of accounts and aliases when a domain is deleted..UNINDENT.spExample:.sp.nf.ftC[domain]auto_postmaster = truedelete_directory = falsedirectory_mode = 504force_deletion = false.ftP.fi.SSMAILDIR.spThe \fBmaildir\fP section is used to specify some default options for newcreated Maildirs and folders inside..INDENT0.0.TP.B\fCfolders\fP\fIString\fP.spA colon separated list of folder names, that should be created. If nofolders should be created inside the Maildir, set the value of thisoption to a single colon (\(aq\fB:\fP\(aq)..spIf you want to create folders containing one or more subfolders, separatethem with a single dot (\(aq\fB.\fP\(aq)..TP.B\fCname\fP\fIString\fP.spDefault name of the Maildir folder in users home directories..UNINDENT.spExample:.sp.nf.ftC[maildir]folders = Drafts:Sent:Templates:Trash:Lists.Dovecot:Lists.Postfixname = Maildir.ftP.fi.SSMISC.spThe \fBmisc\fP section is used to define miscellaneous settings..INDENT0.0.TP.B\fCbase_directory\fP\fIString\fP.spAll domain directories will be created inside this directory..TP.B\fCpassword_scheme\fP\fIString\fP.spPassword scheme to use (see also: \fBdovecotpw \-l\fP)..TP.B\fCgid_mail\fP\fIInt\fP.spNumeric group ID of group mail (\fImail_privileged_group\fP from\fIdovecot.conf\fP).TP.B\fCtransport\fP\fIString\fP.spDefault transport for domains and accounts. For details see\fBtransport\fP(5)..TP.B\fCdovecot_version\fP\fIInt\fP.spThe concatenated major and minor version number of the currently usedDovecot version. (see: \fBdovecot \-\-version\fP)..spWhen, for example, the command \fBdovecot \-\-version\fP prints \fI1.1.18\fP, setthe value of this option to \fB11\fP..UNINDENT.spExample:.sp.nf.ftC[misc]base_directory = /srv/mailpassword_scheme = CRAM\-MD5gid_mail = 8transport = dovecot:dovecot_version = 11.ftP.fi.SHFILES.INDENT0.0.TP.B\fI/root/vmm.cfg\fP.nfwill be used when found..fi.sp.TP.B\fI/usr/local/etc/vmm.cfg\fP.nfwill be used when the above file doesn\(aqt exist..fi.sp.TP.B\fI/etc/vmm.cfg\fP.nfwill be used when none of the both above mentioned files exists..fi.sp.UNINDENT.SHSEEALSO.spvmm(1), command line tool to manage email domains/accounts/aliases.SHCOPYING.spvmm and its manual pages were written by Pascal Volk and are licensed underthe terms of the BSD License..SHAUTHORPascal Volk <neverseen@users.sourceforge.net>.\" Generated by docutils manpage writer..\" .