1. Introduction

VMailMgr (short for Virtual MAIL ManaGeR) is a package of programs designed to manage multiple domains of mail addresses and mailboxes on a single host. It co-operates with qmail for mail delivery and program control.

1.1 What is VMailMgr and why should I use it?

VMailMgr is:

A series of utilities for managing virtual domains which include a password checking interface for qmail which replaces the usual checkpassword, and an authentication module for Courier IMAP, that provide access to the virtual mailboxes by one of three methods:

• IP-based virtual server access (invisible to the POP3 user)
• username-based access (username-virtualuser)
• hostname-based access ([email protected] or virtualuser:virtual.host)

You should use it if:

You prefer to have each domain controlled by a seperate username, allowing the use of system quotas and better security

1.2 New versions

The newest version of this can be found on my homepage http://www.clearrivertech.com/linux/HOWTO as SGML source, as HTML and as TEXT. Other versions may be found in different formats at the LDP homepage http://www.linuxdoc.org/. A copy can also be found on the VMailMgr homepage http://em.ca/~bruceg/vmailmgr/ in its HTML version as well as in the VMailMgr source package as both SGML source and as HTML.

1.3 Comments

Comments on this HOWTO should be directed to the VMailMgr mailing list. To subscribe, send an email to .

1.4 History

This document was started by Bruce Guenter and reworked by Dan Kuykendall.

1.5 Version History

Old Version

• Created by Bruce, wasn't in SGML HOWTO format.

v1.0 (April 20, 2000)

• Built proper SGML version.
• Included the FAQ.
• Other minor additions.

v1.1 (April 23, 2000)

• Split the FAQ to a seperate file, but included some important info from the FAQ.
• Updated the Courier-IMAP support section.
• Switched the license to the GNU FDL.
• Other minor additions.

1.6 Copyrights and Trademarks

Copyright (c) Dan Kuykendall. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation

A copy of the license is available at GNU Free Documentation License.

1.7 Acknowledgements and Thanks

Thanks to Bruce Guenter for VMailMgr and the core of this HOWTO. Thanks to Mike Bell, who always seems to have the answers to my questions. Finally, thanks to all those on the mailing list who have helped me, or asked the same stuff so many times that I had to write this to stop the repeat questions.