Mail Autodiscovery

autodiscover-go

This service publishes IMAP and SMTP settings over standard HTTPS XML endpoints so modern email clients can configure accounts from an email address alone.

Allowed domains stevem.io
IMAP mail.stevem.io:993 over SSL
SMTP mail.stevem.io:465 over SSL

Published endpoints

  • /healthz returns plain-text health status for load balancers and Docker health checks.
  • /autodiscover/autodiscover.json/v1.0/<email> intentionally returns 404 so Outlook does not classify this host as an ActiveSync endpoint.
  • /autodiscover/autodiscover.xml and /.well-known/autodiscover/autodiscover.xml serve Outlook-style autodiscover XML.
  • /mail/config-v1.1.xml and /.well-known/autoconfig/mail/config-v1.1.xml serve Thunderbird-style autoconfig XML.

How clients use it

Clients derive the domain from an address like [email protected], probe conventional HTTPS hostnames such as autodiscover.stevem.io or autoconfig.stevem.io, then parse the returned XML to learn server names, ports, TLS mode, and login format.

Example: Thunderbird-style response

<clientConfig version="1.1">
  <emailProvider id="stevem.io">
    <incomingServer type="imap">
      <hostname>mail.stevem.io</hostname>
      <port>993</port>
      <socketType>SSL</socketType>
    </incomingServer>
    <outgoingServer type="smtp">
      <hostname>mail.stevem.io</hostname>
      <port>465</port>
      <socketType>SSL</socketType>
    </outgoingServer>
  </emailProvider>
</clientConfig>