#pragma section-numbers off

This page describes how to use virtual mailboxes.

[[TableOfContents]]

== Introduction ==

Virtual mailboxes are a good way to give someone a "vanity address" on one of your domains, where they can receive and check email.  You may create virtual e-mail boxes for any domains for which you have write permission in DomainTool.

Before continuing, please note that DomTool allows you to create aliases that forward mail from one address to another. Aliases are much preferable to extra mailboxes, both in terms of conserving server resources and convenience for you, as you can continue checking one mail account even if multiple aliases point to it. The basic rule is: If you are creating a virtual mailbox that only you will read, or if you are creating multiple virtual mailboxes to be read by the same other person, then you should be using aliases instead.

== Administration ==

We use a custom program called `vmail` to manage delivery to virtual mailboxes.  It may be invoked with '''`vmail $DOMAIN $COMMAND`''', which indicates that you are configuring the virtual mailboxes for domain '''`$DOMAIN`''' for which you have DomTool permissions.  The valid commands are:

 * `list`: Print the mapping from usernames to mailbox directories for `$DOMAIN`.
 * `add $USER $MAILBOX`: Add a mapping from `$USER@$DOMAIN` to a Maildir directory `$MAILBOX`.  You'll be prompted to enter a password for the user, which he can then use to access IMAP, POP, or restricted SMTP services.
 * `passwd $USER`: Reset a virtual user's password.
 * `rm $USER`: Remove a mapping.  The mailbox directory remains for you to deal with as you like.

== Access ==

People with virtual mailboxes may use the normal services for accessing their email, such as SSL IMAP and POP, and the [http://mail2.hcoop.net] web interface.

== Changing password ==

People with virtual mailboxes may change their password using the handy web interface at [https://members2.hcoop.net/passwd].