Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



VPS v2: virtusertable: Domain Based E-mail Routing

bullet Introduction

Incoming E-mail messages can be sorted based on the recipient domain name with the virtusertable utility. Because user accounts are not directly associated with any specific domain names, a virtusertable must be used to differentiate between recipient domain names. For example, a virtusertable mapping will allow you to direct E-mail messages for and to different users on your VPS v2.


bullet Configuring Virtusertable mappings

In order to create virtusertable mappings, you must first create a text file in the /etc/mail/ directory of your server (there is a sample file in that directory named virtusertable.sample). This file will contain virtusertable mappings.

Each entry in a virtusertable should be on a single line. The original recipient address on the left hand side, with one or more spaces or tabs separating it from the right hand side, which contains the destination address.

The original recipient is the E-mail address that people will send messages to, and can be either a full address (, or a catch all for all messages to the specified domain (.name). If you want to create multiple virtusertable entries for a single domain, make sure that you put the catch all below any other entries for that same domain name.

The destination address should be a local user, an alias, or a remote Email address. You may also use a %1 to indicate that the original user should be prepended to a catch-all.

Any time you make a change to the /etc/mail/virtusertable text file, you will need to create a db file that sendmail can read. The following command will create the /etc/mail/virtusertable.db file when run by root.

# makemap hash /etc/mail/virtusertable < /etc/mail/virtusertable


bullet Example Virtusertable Entries

The following entry would deliver any message sent to to the local account floydr.		floydr

The next entry will deliver a message sent to to his Email account with his ISP.

Any other Email sent to the domain will go to Floyd's local account.			floydr

Anything sent to a user at will be sent to, but will not change the username the message was originally sent to (only the domain is modified).


Toll Free 1-866-GSP-4400 • 1-301-464-9363 •
Copyright © 1994-2016 GSP Services, Inc.