The following steps are necessary to set up a virtual domain with vmailmgr
(assuming vmailmgr has been compiled and installed). As an example, we'll
set up a virtual user `me@mydomain.org`, with aliases of `myself@mydomain.org`
and `myname@mydomain.org`.

Set up a DNS entry for the domain. I won't cover this here, as it is dependant
on far too many other things.
I will mention that to make IP based virtual domains work a PTR record which matches
an entry in virtualdomains is nessesary, for example, if nslookup 10.56.33.122 returns
mail.mydomain.com, `virtualdomains` needs an entry like `mail.mydomain.com:myuser`

For the example, we'll assume that the mail exchanger for mydomain.org is already set up to point to your computer.

Set up a base user for the domain. Create a user, with a name of your choosing.
Since the maildirs for all the users in the virtual domain will be stored under
this user's home directory, make sure you set the user up in a partition or disk
that is appropriate for such storage. The tools that you should use to accomplish
this step vary greatly between different systems. For our example, I'll add a user `myuser`.

Configure qmail to recognize the domain. To do this, you need to modify two of
qmail's configuration files in `/var/qmail/control` `rcpthosts` and `virtualdomains`.

To `rcpthosts` :
add the line `mydomain.org`.

To `virtualdomains` :
add the line `mydomain.org:myuser`.

If you wish to have mail to `anything.mydomain.org` be delivered in the same way, add the following

To `rcpthosts` :
add the line `.mydomain.org`.

To `virtualdomains` :
add the line `.mydomain.org:myuser`.

Configure qmail-popup/qmail-pop3d to use `checkvpw` as the password checker. This step
is dependant on how you have installed qmail.

Replace `checkpassword` in the command you use to invoke qmail-popup/qmail-pop3d
(either in `/etc/inet.conf` or in a `tcpserver` command) with `checkvpw`.

Add users or aliases to the domain. Either change user to the user you just created
(for example, type `su - myuser`) or log in (with either telnet or at the console) as
the new user, and use the included programs to add users and aliases.

For our example, we would

type: `vadduser me` (which prompts for a password)

type: `vaddalias me myself`

and type: `vaddalias me myname`

After you have completed all these steps, you will need to kill and restart `qmail-send` to
make it read the new `virtualdomains` table.

If you are using `inetd` to launch `qmail-popup`, `kill -HUP` the `inetd` process as well.

Logging in as a virtual user?

There are two ways to log in without using multiple IP addresses.

The first way is to log in as `userSEPvirtual.domain.org`, where `user` is the mailbox name of the virtual user, SEP is one of `@` or
`:` (by default, this is configurable in the `/etc/vmailmgr/' directory), and `virtual.domain.org' is the virtual domain's name, as
listed in `/var/qmail/control/virtualdomains'.

The second way is to use the internal form of the mailbox name -- that is, `baseuser-user', where `user' is the same as above, and
`baseuser' is the username of the managing user.

Example: `/var/qmail/control/virtualdomains' contains

testdomain.org:testuser

User `myuser' exists, and has set up a virtual mailbox with the name `me'. The `separators' variable in `/etc/vmailmgr/' contains
`@:'. This virtual user could log in as `me@mydomain.com', `me:mydomain.cm', or `myuser-me'.

In the `vmailmgr/' configuration directory, there is an entry called `default-username'. If mail to a virtual domain does not match any
users or aliases in that domain, it is delivered to the name listed in this configuration item if it exists (which defaults to `+'). To make this deliver
to you, simply type: