Wdes Mail AutoDiscover-AutoConfig

Support

• Thunderbird
• Microsoft Outlook
• Apple MacOS
• Apple iOS

Inspiration

• mailcow's autodiscover-json.php
• Monogramm's autodiscover-email-settings Node project
• Wicloz's EmailAutoConfig templates
• Mailu's logic for AcceptableResponseSchema
• hmlkao's php-autodiscover for Apps to test
• StephanvanSchaik's automail project written in Rust

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

• Merge the Apple code with StephanvanSchaik's automail, ref: StephanvanSchaik/automail#1.
• Test // Used by Microsoft Office 2009 (to be confirmed) and adjust the code comments.