# Adding a Virtual Host

If you want IMail Server to receive mail for a second e-mail domain that has its own set of users, you need to set up a virtual host for the second domain. For example, if your mail server provides mail service for the e-mail domain, domain1.com, and you also want it to provide mail service for another e-mail domain, domain2.com, you need to create a virtual host for domain2.com. There are two types of virtual hosts:virtual hosts with IP addresses and virtual hosts without IP addresses.

See the chapter on configuration, in the IMail Server User's Guide for information about the two types of virtual hosts, including their limitations and DNS setup for virtual hosts.

## To add a virtual host:

1. From Administration Account Options, select Virtual Hosts.

2. On the Virtual Host Administration page, click Add Host. The Add Virtual Host page appears. The list box shows all IP addresses set up in the Windows NT TCP/IP properties as well as any virtual IP addresses assigned by the IMail Server.

3. Do one of the following:

- To use a real IP address for the virtual host, select the Real IP option, and then select the IP address from the Real IP list box.

- To use the next available virtual address, select Virtual (above the list box). The address is shown under Virtual Address.

4. Official Host Name. Enter the name of the mail host. The name you enter here will be used to address mail to the users on the virtual host. For example, if you enter mail.domain2.com as the mail host name, any users you add to the virtual host will receive mail at user@mail.domain2.com.

5. Aliases. Specify alternate host names for which you want the host to accept mail. For example, if your mail host name is mail.domain2.com, you can set an alias of domain2.com so that IMail Server accepts mail addressed to fred@mail.domain2.com and also fred@domain2.com. Multiple aliases are separated by a space.

6. Top Directory Name. Enter the name of the directory where the directories for users, lists, and web files for this virtual host will be stored. In most cases, you will want to use a different directory for each virtual host that you create. It is possible for virtual hosts to share a single directory but then users that have the same names will actually share the same mailbox.

7. Enter the parameters for mailboxes and messages. These parameters apply to all users on the virtual host.

- Max Mailbox Size. The maximum size (in bytes) allowed for the total of all mailboxes in a new user's account. If the total size of a mailbox exceeds the size entered here, all new mail for the user is returned to the sender. Enter zero for an unlimited size. This value is the default limit used when the Max Mailbox Size value for the user's account is set to zero (in IMail Administrator). Changing this option will automatically change the limit for all accounts on the host with zero as the Max Mailbox Size. Otherwise, the user's Max Mailbox Size value will be used.

- Max Number Messages. The maximum number of messages allowed (the total for all mailboxes created in the user mail account). If this maximum is exceeded, any new mail for the user is returned to the sender. Enter zero for an unlimited number. This value is the default limit used when the Max Messages value for the user's account is set to zero (in IMail Administrator). Changing this value will automatically change the limit for all accounts on the host with zero as the Max Mailbox Size. Otherwise, the user's Max Messages value will be used.

- Single Message Max Size. The maximum size (in bytes) allowed for a single message sent to the server. If a message exceeds the maximum, it is returned to the sender. Enter zero for an unlimited size.

- Maximum User Count (not functional in the IMail 25 version). The maximum number of users that can be registered for the domain. Enter zero for an unlimited number of users. Note that this does not apply to virtual domains that are based on the Windows NT user database or an external database. The displayed counts for those domains may not be correct.

- Maximum Number of login Attempts. The maximum number of login attempts allowed before the account is suspended.

- Maximum Number of Times Suspended. The maximum number of times a user can be suspended before being locked out.

- Maximum Suspended Duration. The number of seconds an account will be suspended if a user has exhausted the maximum number of login attempts.

- Maximum Outbound Message Size. The maximum size allowed for an outbound message being sent by a local user. Any message that is larger than the size entered here, will be bounced.

- Full Mailbox Notify. If there is anything entered in this box, the user will be notified when their mailbox is within the specified percentage of being full. For example, if 80 is entered in this box, the user will receive an e-mail when their mailbox is 80% full. A user will receive a maximum of one e-mail a day for three days. See also, Customizing the Notification Message.

- Full Mailbox Notify Address. Enter the address of an additional address where an e-mail will be sent when a user's mailbox is almost full. For example, this could be the system administrator's address.

8. Sub Mailbox Creation. IMail Server does not allow the automatic creation of sub-mailboxes via a sub mailbox delimiter. This setting allows the administrator to specify what to do when a message arrives for a user and is addressed to a sub-mailbox which does not exist. Select one of the following actions:

- Create. Creates the sub-mailbox and delivers the message.

- Send to Inbox. Does not create the sub-mailbox. Instead the message is delivered to "main".

- Bounce. Bounces the mail as an invalid user.

9. Select the options to enable for the virtual host. The following options apply for the entire domain.

- Enable Virus Scanning. If this option is enabled, then virus scanning is enabled for the entire domain. If this option is cleared, virus scanning is disabled for the entire domain. This option is only visible if you have IMail Anti-Virus installed, and virus scanning is enabled in IMail Administrator.

- Enable Spell Checking. Enable the spell check when composing messages.

- Enable IMail Web Calendaring. Allows users to access IMail Web Calendaring from IMail Web Messaging.

10. Select the connection type. The following options apply for the entire domain.

- Enable SSL. Allows the option of using Secure Socket Layers for security.

- Force SSL. Forces the virtual host to use Secure Socket Layers for security.

Note: If the default domain is set to Force SSL, all virtual domains will also be restricted to using SSL. This is because the login page is based upon the default domain's settings. However, if a virtual domain is set for Force SSL there will be no impact on other virtual domains or for the default domain.

11. Click Save to save the new virtual host configuration.

## Related Topics

Modifying Virtual Hosts

Adding User Mail Accounts