Provides IMAP/SMTP Autodiscover capabilities on Microsoft Outlook/Apple Mail, Autoconfig capabilities for Thunderbird, and Configuration Profiles for iOS/Apple Mail.
The config files (and this README file, to a large extent) are copied from the excellent Incruises autodiscover.xml repo, but the code was re-written in Go instead of Java Script and the functionality to handle TLS/SSL connections was added.
To run the server, complile cmd/autodiscover/main and run it like so:
autodiscover --config=<path to your config file>
See config directory for the example of the config file. There are additional command line arguments to specify certificate and key if you want to handle TLS/SSL connections.
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): https://testconnectivity.microsoft.com (Click on "Outlook Autodiscover")
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 |
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
Create CNAME DNS Records that alias imap/smtp to your machine, like so:
| Name, Host, Alias | Value, Destination | TTL |
|---|---|---|
| imap | mail.mydomain.com | 3600 |
| smtp | mail.mydomain.com | 3600 |
Feel free to fork this repository and modify it to your needs.
This project is distributed under the MIT License