wdes/mail-autodiscover-autoconfig repository overview

⁠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

⁠Mobile email clients

⁠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)