Set up Autodiscover for SmarterMail

What is autodiscover? Simply put, it allows email clients to automatically determine the mail server address and port simply from the user's email address and password. This greatly simplifies the setup process for new users or for setting up devices such as the iPhone, iPad or Android and Windows Phone devices.

Applies to SmarterMail 10.x - 15.x

To set up autodiscover for use with SmarterMail you will need to do the following:

  1. Create an A Record in your DNS
  2. Create a SRV Record in your DNS
  3. Create an IIS binding for autodiscover on your SmarterMail server

At the end of the article, we've listed what you can expect to be returned by a few devices and email clients once autodiscover is set up and working.

Creating an A Record

For autodiscover to work, you should create an A record for "autodiscover.your_domain.ext" that points to the IP address of your mail server. In the case of SmarterTools, we set up an A record for "autodiscover.smartertools.com" that points to the IP address of our mail server (mail.smartertools.com). In our DNS, the line in our zone file for this A record looks like this:

autodiscover IN A 69.71.61.105

NOTE: There are many ways to manage DNS for a domain, as well as many DNS services that can be used, so providing step-by-step instructions is difficult. However, adding a record should be fairly straightforward. If you have questions, contact your IT professional or hosting provider for assistance.

Set up a SRV record in DNS

NOTE: To utilize autodiscover for e-mail clients, SmarterMail must be configured in IIS (NOT the default web server) and be listening over HTTPS. Therefore, port 443 MUST be available and not blocked by a firewall.

Next, you'll want to create a SRV record for your domain. This SRV record will return the available domain and service (SMTP, POP or IMAP) to the e-mail client querying for auto discovery. Technically, setting up a SRV record is an optional step when setting up autodiscover, but it is highly recommended as a backup to ensure autodiscover works properly.

The SRV record that is created should be in the following format: "_autodiscover._tcp.(your domain)" and return the root URL of your email server. Please check with your DNS provider for instructions on configuring an SRV record for your environment.

The following is an example details the SRV for SmarterTools:

Domain: smartertools.com
Service: _Autodiscover
Protocol: _tcp
Priority: 0
Weight: 0
Port: 443

Verifying the SRV via NSLookup

To verify that you have set up the SRV record correctly, on a Windows machine open a command prompt and do the following:

  1. Type NSLOOKUP and press ENTER
  2. Type set type=srv and press ENTER
  3. Type _autodiscover._tcp.your-domain.com, where "your-domain.com" is the name of your domain, and press ENTER

You should get something back that looks like this. NOTE: IPs and server URLs will match what you have set up for your mail server:


    Server: UnKnown
    Address: 127.0.0.1

    Non-authoritative answer:
    _autodiscover._tcp.your-domain.com SRV service location:
    priority = 0
    weight = 0
    port = 443
    svr hostname = mail.your-domain.com

    mail.your-domain.com internet address = 127.0.0.2

Create a Host Header (IIS Binding) for Autodiscover

A binding for autodiscover should be added to your SmarterMail website in IIS that points your autodiscover A record to your SmarterMail installation. Again, to use SmarterTools as an example, we have an IIS binding that binds port 80 and 443 to "autodiscover.smartertools.com." This is added in addition to the IIS binding for "mail.smartertools.com" as the "mail.smartertools.com" URL is what we use for setting up our email clients and for access to the Web interface.

From here, you should be able to open Outlook (or other desktop or mobile email client) and simply add the full email address and password and SmarterMail will take care of the rest.

Protocols Returned by Autodiscover

Not all devices and email clients handle autodiscover in the same way. Below is a list of devices and email clients and the protocols they return when seeking autdiscover settings from a mail server. This will help set expectations for users when setting up accounts using these clients.

  • Mobile devices (iOS, Android, Windows) will only return Exchange ActiveSync
  • Outlook 2007 and above will return IMAP
  • Windows 8 mail client will return Exchange ActiveSync
  • Thunderbird does not support autodiscover but will try best effort to connect to any mail server

Applies to SmarterMail 8.x - 9.x

This feature is not available in these versions.

 

Learn more about SmarterMail's enterprise email features and benefits.

Feedback

Add Feedback
The section "Create a Host Header (IIS Binding) for Autodiscover" is too generic and doesn't say anything useful. Where do I point it on the local system? The root of my Smartermail install exposing all my files? There is no 'autodiscover.xml' within the install.
Brent Lindell (June 18, 2013 at 11:11 AM)
Brent, all you need to do is add a binding to your SmarterMail website in IIS, using the same IP, for autodiscover.domain.extension and save it - there's no pointing to any local directory or anything as you're simply adding a binding for autodiscover to your existing SmarterMail website. We will attempt to make that section a little clearer, however.
Derek Curtis (August 14, 2013 at 8:52 AM)
Unless something has changed, I think it should be clarified that Autodiscover for IOS, Android and Windows requires an ActiveSync license for the account being configured. This isn't very clear or obvious.
Brian Davidson (March 7, 2014 at 2:53 PM)
Just wondering if anyone has found a way to do auto discover without using ActiveSync
Brian Davidson (November 7, 2014 at 12:57 PM)
Creating an A Record cause Outlook to prompt SSL certificate not trusted. Unless you have a wildcard or SAN SSL certificate. If you are using cheap single domain name SSL certificate, just create the DNS SRV record.
BIS Techies (Rebecca and Family) (April 8, 2014 at 7:15 PM)
How to add these to cPanel Advanced DNS running its own autodiscover. We are running on a Sub-domain.
Chinmay Khandekar (December 16, 2014 at 6:28 PM)
Hi Chinmay, That is actually something you'll need to contact cPanel about.
Andrea Rogers (December 17, 2014 at 8:47 AM)
Thunderbird supports autodiscover (they call it autoconfiguration):

https://wiki.mozilla.org/Thunderbird:Autoconfiguration

This was covered in previous forum which is now not available. Can you make official support for thudnerbird autoconfiguration?

Webio (May 26, 2015 at 12:12 AM)
I have set it up like this, so customers kan connect to the smartermail server using the ssl cert of the mailserver.

Non-authoritative answer:
_autodiscover._tcp.client-domain.com SRV service location:
priority = 0
weight = 0
port = 443
svr hostname = mail.hosting-isp-domain.com

mail.hosting-isp-domain.com internet address = <public IP nr>

Richard Frank (April 6, 2016 at 3:43 AM)
SNI must be enabled when adding the new binding in order to select a different SSL certificate for the autodiscover.domain.ext. Otherwise, it will use the same SSL certificate as your webmail, which will throw up warnings when trying to autodiscover.
Stephen Roesch (November 2, 2016 at 7:06 AM)
So, if you need to add autodiscover.x.x for port 80 and 443 on the existing SmarterMail server's IIS, it throws up the "Binding already being used by a product other than IIS”. I added a second IP to the site and bound autodiscover to those, but it still won't resolve for clients. ?
Andrew Lupton (January 9 at 1:05 PM)
Hi Andrew! Thank you for reaching out. I would encourage you to review this issue with our Support Department through the use of an Email or Phone Ticket. Please keep in mind that if the issue is determined to be caused by a bug in the software, your ticket / ticket costs would be refunded.
Andrea Rogers (January 18 at 4:12 PM)

Add Feedback