Reseller plans

Get started with Reseller (RE-xxx & RP-xxx) plans.


This document contains information specific to resellers but it is not a complete replacement to the other ‘Hosted email’ docs. Please follow them to know more about setting up DNS records, adding domains and accounts, etc.

Provision server

Self server installations are available for Reseller-Enterprise servers: RE-250, RE-500, RE-1000 & RE-2000 plans. Servers can be installed from console. All other plans will be provisioned in 24-48 hrs; you will receive an email with all the pertinent details once the server is provisioned.

Read Getting started for more information on provisioning server.


  • Use A record (alt.yourdomain.tld) mapped to IPs of ( and ( to create your own backup MX records.
  • SPF records can also use own domain. For example, your clients can use record v=spf1 include:yourdomain.tld -all and make sure to have yourdomain.tld’s SPF as v=spf1 mx -all


Do not change the -all qualifier in the above record to any other value when using Premium relay (mails will be rejected otherwise). Premium relay (external SMTP relay for high deliverability) is enabled by default for all reseller plans.

SPF is configured as a TXT record in your DNS manager. SPF should not be configured using the deprecated SPF record type. A domain should have only 1 SPF record; remove your old host’s SPF record (if any).

Provisioning accounts

  • Use Resellers account type (permission level) to provision accounts for your clients. Once the Resellers account is created from Mail portal/admin panel (Identities tab), click the edit button > Resources > set the desired values.
  • The Resellers user can also be created through the API. See API docs for more information on accessing API docs, enabling API and getting your API keys.
  • WHMCS plugin for reselling can be downloaded from the client area. Once logged in, from the menu bar > select Services > My services > select your reseller service > Downloads (left side menu).
  • Refer to WHMCS plugin section below for plugin setup instructions.


The Resellers user is the correct account type (permission level) to use to provision accounts for your clients/end-users. When you’re a reseller yourself, it can be quite confusing to provision end-user accounts using the Resellers permission level (after all, you’re the reseller and not your end-user). We’re sorry for the naming choice but it is the correct permission level to use.

This permission level allows you (the administrator) to provision account for your client (end-user) based on number of domains, mailboxes, aliases, storage quota, etc.

For more information on permission levels, see Setup Mail documentation.

WHMCS plugin

WHMCS is an all-in-one client management, billing & support solution for online businesses (not included). Paired with Mailcheap’s WHMCS plugin, you can automatically provision end-user accounts (for your clients) based on storage and number of domains/mailboxes/domain admins/domain aliases/mailbox aliases.

WHMCS plugin is a provisioning module which creates a Resellers user according to the product/plan specification (number of domains, mailboxes, storage quota, etc.) set by the administrator (you) in WHMCS.

WHMCS plugin can be downloaded from the client area. Once logged in, from the menu bar > select Services > My services > select your reseller service > Downloads (left side menu).

Install WHMCS plugin

  • Unzip the WHMCS plugin. Make sure you have downloaded the correct plugin depending on your PHP version.
  • Upload “modules/servers/modoboa” directory to your whmcs install “modules/servers/” folder.
  • Set the correct permissions for the above uploaded folder and its subfolders/files.
  • Your directory structure should now look like this ../your-whmcs-install-folder/modules/servers/modoboa/..

Setup server in WHMCS

Step 1. From your WHMCS admin portal > navigate to Setup (menu bar) > Products/Services > Servers.

Step 2. Create a server group by clicking Create New Group.

Step 3. Create a server by clicking Add New Server and assign it to the previously created server group.

Fill in the below fields:

  • Name: Your-mail-server-name
  • Hostname: Your-mail-server-hostname
  • IP Address: Your-mail-server-IP

  • Type: Modoboa

  • Access hash: Your API key

Step 4. Check (enable) the option Tick to use SSL Mode for Connections.

Step 5. Press the red Test Connection button, it should show green “SUCCESSFUL!” message.

Step 6. Click Save Changes button.

Setup product in WHMCS

Step 1. From your WHMCS admin portal > navigate to Setup (menu bar) > Products/Services > Products/Services > Create a New Product > follow on-screen instructions.

Step 2. In Module Settings tab > choose Module Name Modoboa from the drop-down menu.

Step 3. Assign the previously created server group to the product in the Server Group field.

Step 4. Set the product/plan account (Resellers user) limits. You’re able to set storage quota in MB, number of mailboxes, number of domains, aliases, etc.

Step 5. Check (enable) the option Do not automatically setup this product.

Step 6. In Custom Fields tab > Add New Custom Field with Field Name pk and Field Type Text Box. Unckeck all other options.

Step 7. Click Save Changes button.

Setup product welcome email

Set up a welcome email template for your product/plan in WHMCS. This welcome email will be sent to your client (end-user) upon product activation and will include login details and other information for them to get started with their hosted email plan.

Step 1. From your WHMCS admin portal > navigate to Setup (menu bar) > Email Templates > Create New Email Template > choose Email Type as ‘Product/Service’ and Unique Name as ‘Your-product-name Welcome Email’ > click Create button.

Step 2a. In the following ‘Your-product-name Welcome Email’ template page, choose Subject as ‘New Product Information’ and in the body (text area) enter the below details (modify accordingly):

Dear {$client_name},

Your order for {$service_product_name} has now been activated. Please keep this message for your records.

Product/Service: {$service_product_name}
Payment Method: {$service_payment_method}
Amount: {$service_recurring_amount}
Billing Cycle: {$service_billing_cycle}
Next Due Date: {$service_next_due_date}

Login Details:

Server hostname: {$service_server_hostname}
Web admin panel: https://{$service_server_hostname}
Webmail (SOGo): https://{$service_server_hostname}/webmail/
Webmail (Afterlogic): https://{$service_server_hostname}/afterlogic/
Username: {$service_username}
Password: {$service_password}

Get started with your hosted email service by following our documentation: <enter your documentation URL here>

Please keep this email safely as it contains your access credentials, mailserver hostname, etc. Its highly recommended to change the above password upon login. Use a password manager to create random passwords for all your accounts.

Thank you for choosing us.


Step 2b. Click Save Changes button.

Step 3. From your WHMCS admin portal > navigate to Setup (menu bar) > Products/Services > Products/Services > select the product you set up earlier > Welcome Email > choose ‘Your-product-name Welcome Email’ from the drop-down menu > click Save Changes button.


  • Server log for auditing/troubleshooting can be found in Server stats & tools portal at your mailserver’s homepage. All reseller plans support overselling but we recommend to monitor the health metrics from Server stats & tools portal so as not to overload the server and cause service disruption.
  • Refer to Mailcheap status for scheduled/ongoing maintenance updates.