Skip to content

A docker image to deploy to have a dynamic autodiscover XML and autoconfig XML host. Supports Outlook, Thunderbird, Apple, some Android apps, and more..

License

Notifications You must be signed in to change notification settings

wdes/mail-autodiscover-autoconfig

Repository files navigation

Wdes Mail AutoDiscover-AutoConfig

dependency status Build and test rust code maintenance-status

Support

  • Thunderbird
  • Microsoft Outlook
  • Apple MacOS
  • Apple iOS

Inspiration

Tested email clients

Email client Tested version
Apple MacOS Monterey on Apple Mail MacOS: 12.2, Mail: 15.0 (3693.60.0.1.1)
Thunderbird 91.10.0
Evolution on Ubuntu 3.40.0
KMail on Ubuntu 5.19.3 (21.12.3)
Microsoft Office Pro Plus 2013 15.0.5399.1000 64 bits
Microsoft Office Pro Plus 2021
*You need to disable Office 365 setup and adjust the config manually
14326.204454 64 bits

Mobile email clients

Email client Tested version
Apple iOS 15.6.1 iOS: 15.6.1
FairEmail 1.1917
K-9 Mail since 6.709 6.709
Android Nine 4.9.4b
Spark Mail on Android 2.11.8
MailTime on Android 2.5.4.0614
Maily on Android 1.0.0
ProfiMail on Android 4.31.08

Usage

Pull the image: docker pull wdes/mail-autodiscover-autoconfig

Save this docker-compose.yml file and adjust it for your needs.

version: "3"

services:
    mail-autodiscover-autoconfig:
        image: wdes/mail-autodiscover-autoconfig:latest
        mem_limit: 120M
        mem_reservation: 50M
        restart: on-failure:40
        ports:
            - "8088:80"
        environment:
            ROCKET_PROFILE: production
            ROCKET_ADDRESS: "0.0.0.0"
            ROCKET_PORT: "80"
            # https://www.uuidgenerator.net/
            # Re-generate the two UUIDs below
            APPLE_MAIL_UUID: ff83a13b-c4e6-41c5-bf54-0a244bb3bf5d
            APPLE_PROFILE_UUID: b8e39daa-64a3-4928-bb86-cb4b551fdd57
            # CUSTOM_DOMAINS: foo.tld
            # (optional: CUSTOM_DOMAINS) List of domains that will use {imap,pop,smtp}.domain.tld instead of the hosts below
            IMAP_HOSTNAME: imap.mails.provider.tld
            POP_HOSTNAME: pop.mails.provider.tld
            SMTP_HOSTNAME: smtp.mails.provider.tld

Install on Apple

  • Browse https://autoconfig.<domain>.<tld>/apple or directly https://autoconfig.<domain>.<tld>/email.mobileconfig?email=<username>@<domain>.<tld>
  • Fill and submit the form, the profile downloads itself
  • Click on it, it says to go to system settings to enable it
  • Go to system settings, then "Profiles" or "Downloaded Profiles"
  • Click install on the profile, enter your password
  • You can go back to your Mail app, the email configured

NB: Is Apple signing implemented: No. Will it be: maybe, if someone/I figures it out ^^

Technical compilation aspects

You can disable some of the default features. For now the default features are:

  • apple (This feature contains the web UI route and the mobile config route)
  • dns (This feature adds a DNS txt route to obtain your ideal DNS config)

TODO