Set up Hosted Email Services

Short Link : opensrs.help/email-setup

This article explains the process of creating a mailbox and configuring email DNS both in the Reseller Control Panel and the Mail Administration Console (MAC). It also provides configuration details if the mailbox user wishes to use an email client to set up their mail. 

The Reseller Control panel allows you to manage domains, email, trust, publishing, and other reseller account related settings.

The Mail Administration Console (MAC) interface is for administrating email accounts in the OpenSRS Email Service. Most functionality within the MAC is available within the Reseller Control Panel.

Create a mailbox account in the Reseller Control Panel

  1. Sign in to the Reseller Control Panel.
  2. Click on Email.
  3. Click on the blue + icon under Email domains.
    create_email_mailbox.png
  4. Enter the domain you would like to add. This will create the email domain in our system. 
  5. Click on the Email users tab and then the blue + icon to add a new user.
    create_email_users.png
  6. In the next screen, enter the first part of the email address and type in a password that you want to use the email. Then click on Add.

The email account is now created and looks like this. 
sample_mailbox.png

Back to top

Create a mailbox account in the Mail Administration Console (MAC)

  1. Based on your cluster settings use your browser to navigate to the MAC: 
    https://admin.<cluster>.hostedemail.com
  2. Click on Add domain.
    Create_email_domain_MAC.png
  3. In the create domain pop up window, create the new domain name and complete your required setup. Click on Create from the bottom. 
    Create_email_domain_MAC.png
  4. Once the domain is created, users or mailboxes can be created under the domain name by clicking on Add users.
    create_email_mailbox_MAC.png
  5. A new create user window will pop up, and you can create the mailbox as per your requirement. Under Type, mailboxes can be set up as Mailbox, Forward or Filter.  Under User, enter the mailbox name. Once completed click on Create from the bottom. If you wish to continue creating users click on Create & Repeat
    Create_mailbox_MAC_2.png

Back to top

Configure the MX record to link to our mail server

If the domain's DNS service is managed through OpenSRS, please follow the instruction below. If not, please consult with the DNS/name server provider in order to change the MX record.

  1. Click on Domains tab on the upper left of your reseller control panel. 
  2. Enter the domain name in the search box and press Search.
  3. In the search result, click on the domain name.
  4. Scroll down to the DNS section and click Edit
  5. Click on Add record and choose MX.
  6. Enter the MX record under Hostname and click Save DNS settings.  If your email service is on cluster B, please use the appropriate MX setting for cluster B.
    MX_record_DNS_template.png

The MX record is now set up and should look like this.
MX_record.png

The domain is now linked to the email service. Please wait 15 minutes after modifying the MX record for the record to propagate. You can use any public DIG tool to see if the MX record is propagating. 

Back to top

Sign in to webmail

Sign in to the customer's webmail account after creating the mailbox by using the email address as the username and the password that you set above. The sign-in will depend on the email cluster of your reseller account.

Please refer to our complete Webmail guide for more information on how to navigate webmail settings. 

Configure an email client

If the customer wishes to access email via an email client, please have the customer connect  IMAP and SMTP. The mail servers are:

Server settings for Cluster A

Username your email address
Password your email password
IMAP/POP/SMTP hostname mail.hostedemail.com or mail.emailhome.com

 

Server settings for Cluster B 

Username your email address
Password your email password
IMAP/POP/SMTP hostname mail.b.hostedemail.com or mail.mailconfig.net

 

 Port numbers for Cluster A and B

  SSL Enabled SSL disabled TLS
IMAP 993 143 n/a
POP3 995 110 n/a
SMTP 465 8025 25, 587

 

You can provide the mailbox users with the email client configuration guide for detailed steps. 

The number of mailboxes in the account is tabulated at the beginning of the month and the cost is deducted from the credit in the account at the end of the month. Therefore, if you are experimenting with mailboxes and delete them right after creating them, you will not be charged.

Email accounts that end in .adm are administrative accounts do not incur any charge.

Note: To prevent email accounts from being created for spamming, newly created email accounts will have limits on outgoing emails per day.  The sending limit will increase over a two weeks period to 500 emails per rolling 24 hour period.

Back to top

Helpful articles

 

Have more questions? Submit a request

3 Comments

  • Avatar
    Markus Schrijver

    Is there a chance that OpenSRS will include an XML API instead of/or as well as JSON.

    Or has someone written a PHP script that converts XML or JSON that they would like to share?

  • Avatar
    Aaron Bailey

    Hello Markus,

    OpenSRS doesn't have any plans to produce a script that will convert XML calls to JSON and we don't provide any documents to form calls in XML format for the mail API system either.

    That being said we released a PHP tool kit some time ago which has mail API integration scripts you can use.

    Here is a link to the package:

    https://github.com/OpenSRS/osrs-toolkit-php

    I hope that helps but if you have any other questions you can let us know. Our support contact information can be found @ https://opensrs.com/why/contact/

    Regards,

    Aaron

  • Avatar
    Georgia Jaeger

    Can you tell what "urbl.hostedemail.com" is as it seems to be blocking traffic from our email service? My client does business with someone using hostedemail and is having trouble getting through. None of the parties are blacklisted, I have checked.

    GJ

Please sign in to leave a comment.