Servers and services

Email role

Last updated: November 2022

Support documentation / Email role

If you do not have access to 'Servers > email' you may not have the correct user permissions


The Email role provides the following services:

- POP/IMAP (dovecot)

- SMTP (postfix)

- Spam filtering (rspamd)

Installing the Email role will allow you to create hosting packages with email addresses and forwarder-only accounts. The customer can send messages through SMTP and receive with POP/IMAP. The username is always their email address.

If a website is mapped to an email role (see 'server placement'), that website will be able to send messages using the sendmail binary or PHP mail(). A drop-in sendmail replacement is added to the PHP container which sends through the website's SMTP using a hidden mailbox.

Installing Email role

ℹ️ To run the Email role on a server allow port 143, 110, 993, 995, 25, 587 and 465 on your firewall.

The Email role can be installed on an existing or new server.

To add a Email role to a new or existing server:

  1. Click 'Servers' in the left side bar
  2. Choose the server that you want to add the backup role to
  3. Click 'Add role' and select the 'Email' check box. Complete the form and hit 'Add role'

The hostname should be a hostname that resolves to the server and have a matching reverse DNS

ℹ️ You can navigate away from the server page when a service is being installed and you will be notified when the installation is completed.

ℹ️ The Email role will not automatically be mapped to websites. If you are installing a role which did not previously exist on your Enhance estate and you want to map existing websites to it so they can use the new functionality, use the "Move server" option from the left hand menu.

Email settings

The Email role automatically inherits Enhance's global Service settings. Smart host settings can be overridden on a per server basis.

To configure global Email role settings:

  1. Open 'Settings' in the left sidebar
  2. Select 'Service' settings in the menu
  3. Navigate to the Email' section.

The following Email settings can be configured:

Maximum mailbox message

Applied per hour.

Maximum website messages

Applied per hour per website. This setting will take precedence over maximum mailbox messages.

Smart host setting

This will automatically configure your email server to send all outbound email through a third party with authentication.

To override SMTP settings on a per server basis:

  1. Open ‘Servers’ in the left side bar
  2. Select 'Manage' on the server
  3. Navigate to the ‘Role’ you’d like to configure custom settings for
  4. Click ‘Settings’

Any inherited global settings will be tagged 'Default'. Any custom or edited default settings will not be tagged.

Webmail clients

We currently install Roundcube by default. This integrates with Enhance so that it works with all you email servers from the same webmail link.

Once an email role is installed a 'Webmail' domain is required. This is the domain your customers will visit to access Roundcube.

To set your Roundcube domain:

  1. Open ‘Settings’ in the left side bar
  2. Select ‘Platform’ from the settings menu
  3. Navigate to the ‘Control panel website domains’
  4. Select the edit button next to the 'Roundcube domain‘ field and hit 'Save' to finish

ℹ️ Ensure the DNS for your chosen Roundcube domain name points to your control panel server if the nameservers are external.


Roundcube gives a white page

Roundcube calls back to your control panel website to determine the correct IMAP and SMTP settings for a given mailbox.

Your control panel URL must be accessible from the PHP container running the Roundcube website and located on your control panel server. Your control panel must have a valid SSL certificate (either auto Let's Encrypt or your own custom SSL). If either of these are not true then Roundcube will give a white page on login.

Email tools are not showing on a website

There are a few reasons you may not be able to access Email tools:

  1. Check you have an Email role installed on your servers
  2. Check that the hosting package the website is on has 'Email' resources assigned to it. You can check this by visiting 'Packages'.
  3. Check that the website has an Email role assigned. You can check this by visiting 'Customers' locating the customer and viewing the Website tab. If the website does not have an Email role assigned, you can assign one using the 'Move server' tool.

Certificate warning in Email software

A certificate warning may be shown if the IP or domain you are connecting to does not match one of the SSL Certificates assigned to the server.

To eliminate the certificate warning, add a server domain to each server running the Email role and connect to the server domain when configuring your email software's incoming and outgoing server.

To add a server domain to a server:

  1. Open 'Servers' in the left side bar
  2. Select the Server you would like to add an SSL to
  3. Select the three dots in the top right hand corner of the page and select 'Server domains' from the drop down menu
  4. Navigate to 'Server domain' input the server domain and click 'Add'

Still need help

Our support team are on hand to help 9am - 9pm GMT.