Host Configuration

The Host Configuration menu is where the list of domains CMail distributes mail for is maintained. Advanced Mail Forwarding and SMTP Rulesets are maintained from the Advanced menu.

Setting CMail to handle mail for an Internet domain name
When CMail is run for the first time, the product splash screen will be displayed and immediately afterwards, the 'Hosts/Domains to accept mail for' menu will appear. This menu is where you specify the domain names for which CMail will handle the email. This menu can also be accessed from Configuration > Host Configuration.

  1. Enter your domain or hostname in the New Host/Domain field.
  2. Click the Add button.
  3. The host or domain you entered will appear in the list.

Removing a domain from CMail Server

  1. Highlight the redundant domain name.
  2. Click the Delete button to remove the domain from Domain List.

Primary Domain
CMail requires a Primary Domain. The primary domain is used in server to server and server to client greetings messages.

  1. Enter the same domain name into the Primary Domain field.
  2. Click OK.

The Advanced Menu (Advanced Users)
The Advanced Host Configuration menu allows you to setup forwarding configurations for each domain name contained in the Host Domains List on a per domain basis. 

CMail can be configured to forward all of the mail it receives for the domain name you highlighted to either a specific mail host or a user within CMail itself.

  • To send all mail for the domain to a particular CMail user, click in the field labeled 'To the following Host or User' and select the CMail user from the drop down menu. Click OK to complete the changes.
  • To send all mail for the domain to an external email address, click in the field labeled 'To the following Host or User' and enter the email address of the new recipient in the format user@domain.co.uk. If the address you have entered is external - i.e. elsewhere on the Internet, click 'If server is remote, use Remote Access' and press OK to complete the changes.
  • If you wish to forward all mail for the domain to another mail server, click in the field labeled 'To the following Host or User' and enter the hostname or IP address of the remote mail server. f the address you have entered is external - i.e. elsewhere on the Internet, click 'If server is remote, use Remote Access' and press OK to complete the changes.

If server is remote, use Remote Access
When forwarding mail to an external address or host and you connect to the Internet using the Windows Remote Access server, check this box so CMail will invoke the RAS service to send out the mail.

When forwarding mail first check existing users
Enabling this feature will force CMail to check that none of the forwarded mail is addressed to a local CMail user. Should mail for a local user be found, it will be directed to that users mailbox without being forwarded.

Use advanced ruleset table when forwarding
Rulesets are a new feature as of CMail Server version 2.3. In previous versions of CMail which were setup for multiple domains - a mailbox or an alias would apply to both domains. For example, if CMail was set-up to handle mail for the domains domain1.co.uk and domain2.co.uk, any mail addressed to sales@domain2.co.uk would go to the same user as mail sent to sales@domain1.co.uk.  

Rulesets can be used to distinguish between these domain names allowing the same username to be specified at the different domains. In the example above, mail addressed to sales@domain1.co.uk will be directed to user1 at the local domain and sales@domain2.co.uk will be addressed to user2 at the local domain.

Adding a ruleset (Advanced Users)

  1. Enter the username of the new ruleset in the top username field.
  2. Enter the domain name the ruleset will apply to in the field directly after the '@' sign.
  3. Enter the recipients username in the bottom username box.
  4. Either enter the domain of the recipients email address if it is a domain not handled by CMail or select a local domain from the drop down box.
  5. Select External Spool from the Queue menu.
  6. Click Add to implement the ruleset.

Removing a ruleset (Advanced Users)

  1. Highlight the ruleset you wish to remove in the main rulesets window.
  2. Click delete.

Modifying a ruleset (Advanced Users)

  1. Existing rulesets can be modified. Highlight the ruleset you wish to change and click Modify.
  2. Edit the rulesets as required and then click Save to effect the changes made.

External/Internal Queue
The Queue list defines which mail queue any mail matching a rule will be handled by. In most cases, mail should be handled by the External Spool. If however, you are using rules to forward email to another mail server on the same network or machine, select the Internal Spool.

Exit quits the Ruleset menu.

Configuration Menu
Return to Index