Our Thunderbird mail clients successfully pick up their IMAP settings for their accounts on (Mountain Lion) OS X Server automatically. They just supply their email addresses and Open Directory passwords at mail account setup and Thunderbird does the rest for the client user.

At autoconfig.myexample.com we simply supply a small XML file containing IMAP and SMTP server names and which connection protocols are offered.

Mac Mail does not use this convention though. So the question is: how does the Mac Mail client do autoconfigure - if at all?

I see many discussion threads concerning Mac Mail "autodetect"ing MS Exchange account settings but none answering the question re Mac Mail to IMAP accounts on OS X Server.

If Mac Mail can make it easy for Exchange users I assume that it can also make it easy to get their mail from OS X Server? But how?

2 Answers 2


I did a little digging and found out a little of what OSX tries to do to auto-configure an email account.

In system preferences when adding a mail account, OSX makes a POST to https://mac-services.apple.com/iconfig/dconf the post parameters are:

version: 1
capabilities: MACOSX

For a service like gmail the following is returned:


Unfortunately, for my domain I receive the following response:


As far as I can tell after an unknown response OSX gives up and requires a user to enter the details manually. Capturing network packets I see no attempt by OSX to fallback to using SRV DNS records, or the Exchange Autodiscover.xml mechanism.

If I get a chance I will open a support ticket with apple to see how one gets added to their mac-services list.

  • Did you get anything from Apple on registering an organisation's auto discover info with them?
    – iainH
    Aug 17, 2014 at 9:25
  • No, I never did open a support ticket. You can use OSX Server Profile Manager to help setup accounts on a system, see apple.com/support/osxserver/profilemanager
    – Josh
    Aug 18, 2014 at 15:32

Profile Manager is great if you're using it to deploy devices anyway. But, either way, if you're using OS X Mail Server, just have them add a new Internet Account (through ->System Preferences->Internet Accounts or Mail->Accounts, from the Mail.app client), scroll down to "Add Other Account..." and have them choose "Add an OS X Server account". This will configure all services granted to the user on the OS X Server, such as Mail, Calendar, Contacts, etc.

If you were using a custom POP3 / IMAP server, autodiscover configuration would be difficult to get going with the Mail.app client. But, being that you're using OS X Server accounts, you can directly specify that type of account when adding new Internet Accounts.

Also make sure to configure your autodiscover service locater record in DNS in the form of: _autodiscover._tcp

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .