Provides Autodiscover capabilities for IMAP/SMTP services on Microsoft Outlook/Apple Mail and Autoconfig capabilities for Thunderbird
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
views Make the script more generic, add ENV variables Sep 29, 2015
.gitattributes Add Autodiscover.xml support Sep 14, 2015
LICENSE Initial commit Sep 14, 2015
index.js Make the script more generic, add ENV variables Sep 29, 2015
settings.js Fix settings.js Sep 30, 2015


Provides IMAP/SMTP Autodiscover capabilities on Microsoft Outlook/Apple Mail, Autoconfig capabilities for Thunderbird, and Configuration Profiles for iOS/Apple Mail.


Microsoft Outlook/Apple Mail

URL (POST XML): https://{{app_domain}}/Autodiscover/Autodiscover.xml

Create a SRV DNS Record:

Service Protocol Value, Destination, Target Port Priority Weight TTL
_autodiscover _tcp {{app_domain}} 443 5 0 3600

Test your Autodiscover configuration (Microsoft Outlook): (Click on "Outlook Autodiscover")

Mozilla Thunderbird

URL (GET): https://{{app_domain}}/mail/config-v1.1.xml

Create a CNAME DNS Record:

Name, Host, Alias Value, Destination TTL
autoconfig {{app_domain}} 3600

iOS / Apple Mail

URL (GET): https://{{app_domain}}/email.mobileconfig?email=EMAIL_ADDRESS

Redirect users to above URL and the MobileConfig Profile will be downloaded. The user will be instructed to install the profile to configure their email.


The above autoconfiguration methods assume the following:

  • Username: {{email}} (Entire email address)
  • Encryption: SSL/TLS


I only have one mail server with both IMAP and SMTP on the same machine (

Create CNAME DNS Records that alias imap/smtp to your machine, like so:

Name, Host, Alias Value, Destination TTL
imap 3600
smtp 3600

My settings are different or not compatible with these settings.

Feel free to fork this repository and modify it to your needs.


This project is distributed under the MIT License