Rdswikiadmin: Created page with "Copied from; https://wiki.koozali.org/Autodiscover (last changed; 9 June 2026) {{Languages}} {{#vardefine:contribname| {{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }} {{#vardefine:smecontribname| smeserver-{{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }} {{#varde..."

2026-08-13T08:28:53Z

Created page with "Copied from; https://wiki.koozali.org/Autodiscover (last changed; 9 June 2026) {{Languages}}   {{#vardefine:contribname| {{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }} {{#vardefine:smecontribname| smeserver-{{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }}  {{#varde..."

New page

Copied from; https://wiki.koozali.org/Autodiscover (last changed; 9 June 2026)

{{Languages}}


{{#vardefine:contribname| {{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }}
{{#vardefine:smecontribname| smeserver-{{lc: {{#titleparts: {{BASEPAGENAME}} |1}} }} }}

{{#vardefine:lang| {{lc: {{#titleparts: {{PAGENAME}} | | -1}} }} |en }}
{{Infobox contribs
|name={{#var:contribname}}
|image={{#var:contribname}}.jpg
|description_image= {{#var:contribname}} logo
|maintainer= Unnilennium
|licence= GPL
|url= https://wiki.koozali.org/Autodiscover
|category= Mail
|tags=autodiscover,Email,POP3,POP3S,IMAP,IMAPS,SMTP,autoconfig,config-v1.1.xml
}}

===Maintainer===

[[User:Unnilennium|Jean-Philippe Pialasse]]

=== Version ===

{{#smeversion: {{#var:smecontribname}} }}

=== Description ===
This contribs will deploy Microsoft Autodiscover and Mozilla autoconfig to configure your IMAP POP and SMTP accoutn to your mails clients.
Plan is to also support creation of apple configuration file in the future.

=== Installation ===
prerequisite you need a valid SSL certificate, redirection might fails if https uses a non valid certificate, try [[Letsencrypt]]
<tabs container>
<tab name="For SME 11">
dnf install {{#var:smecontribname}}
</tab>
<tab name="For SME 10">
yum --enablerepo=smecontribs install {{#var:smecontribname}}
</tab>
</tabs>

=== Configuration ===

====Client Side ====
===== Mozilla compatible products =====
Thunderbird, Evolution and any software compatible with the Mozilla Thunderbird .well-known/autoconfig/mail/config-v1.1.xml config file will work by just filling your email and password.

===== Outlook before 2016 =====
Will also work out of the box by just filling your email and password.

===== Outlook 2016 =====
Out of the box, it does not support IMAP POP3 and SMTP autodiscover, but only exchange type server. There are two methods you can use to workaround that.
First is using the old style outlook profile configurator
C:\Program Files (x86)\Microsoft Office\root\Office16\OLCFG.EXE
then button email accounts
or
C:\Program Files\Microsoft Office\root\Office16\OLCFG.EXE
then button email accounts

Second would be to force Outlook to use old detection configuration by manipulating Registry, as a priviledged user run in a windows shell:
reg add "HKEY_CURRENT_USER\SOFTWARE\Policies\Microsoft\Office\16.0\Outlook\setup /T REG_DWORD /F /V DisableOffice365SimplifiedAccountCreation /D 1"

===== Outlook 2019 =====
Out of the box, it does not support IMAP POP3 and SMTP autodiscover, but only exchange type server.
You will need to enable old Outlook 2016 accounts.
see : https://wiki.contribs.org/Email#Outlook_365_.2F_Outlook_2019_IMAP_Configuration

alternatively the Outlook 2016 should work
C:\Program Files (x86)\Microsoft Office\root\Office19\OLCFG.EXE
then button email accounts
or
C:\Program Files\Microsoft Office\root\Office19\OLCFG.EXE
then button email accounts

Second would be to force Outlook to use old detection configuration by manipulating Registry, as a priviledged user run in a windows shell:
reg add HKEY_CURRENT_USER\SOFTWARE\Policies\Microsoft\Office\19.0\Outlook\setup /T REG_DWORD /F /V DisableOffice365SimplifiedAccountCreation /D 1"

===== Outlook 365 =====
Need testing,, does not support IMAP POP3 and SMTP autodiscover. Only exchange type server.

===== Outlook for Android =====
Need testing, but mostly work as Outlook 365.

===== Apple products =====
see bug https://bugs.koozali.org/show_bug.cgi?id=12100

====DNS SRV Record alternate method====
smtp
_smtp._tcp SRV 0 1 25 mail.example.com.
smtps
_smtps._tcp SRV 0 1 465 mail.example.com.
submission (not in use on SME)
_submission._tcp SRV 0 1 587 mail.example.com.
imap
_imap._tcp SRV 0 1 143 imap.example.com.
_imaps._tcp SRV 0 1 993 imap.example.com.
pop3
_pop3._tcp SRV 0 1 110 pop3.example.com.
_pop3s._tcp SRV 0 1 995 pop3.example.com.
{{Note box|Cladav and cardav are not yet implemented for thunderbird xml autoconfig. It relies on RFC 6764, meaning only way is to use th SRV records.}}
caldav with or without TLS , could use a TXT field too, if no txt value is present then client will check /.well-known/caldav
_caldav._tcp SRV 0 1 80 calendar.example.com.
_caldavs._tcp SRV 0 1 443 calendar.example.com.
_caldav._tcp TXT path=/caldav
_caldavs._tcp TXT path=/caldav

cardav , could use a TXT field too, if no txt value is present then client will check /.well-known/cardav
_cardav._tcp SRV 0 1 80 calendar.example.com.
_cardavs._tcp SRV 0 1 443 calendar.example.com.
_cardav._tcp TXT path=/caldav
_cardavs._tcp TXT path=/caldav

==== DNS and file for MTA-STS and TLS-RPT ====
as you are there you can inform the worl you use along side with DKIM, SPF and DMARC properly configured this. See

create a subdomain ''mta-sts.yourdomain.com , make it point to your server, and set [[Letsencrypt|Let's Encrypt]] to create a certificate for it''

fill the content of the file /home/e-smith/files/ibays/Primary/''.well-known/mta-sts.txt with''<syntaxhighlight lang="console">
version: STSv1
mode: testing
mx: yourdomain.com
max_age: 604800
</syntaxhighlight>fill the following records at your dns. (fill the id field with current timestamp, and update the domain/ email to your needs)<syntaxhighlight lang="console">
_smtp._tls.yourdomain.com. 900 IN TXT "v=TLSRPTv1; rua=mailto:admin@yourdomain.com"
_mta-sts.yourdomain.com. 900 IN TXT "v=STSv1; id=1575556993"
</syntaxhighlight>

==== DNS and BIMI Record ====
add a picture as svg accessible with your web srver, be sure DMARC fields are ok. and then file the DNS field, with the correct URL. You might need to check if your SVG is compatible <syntaxhighlight lang="console">
default._bimi IN TXT "v=BIMI1; l=https://yourdomain.com/images/Logo.svg"
</syntaxhighlight>you might also obtain a certificate for your logo after having validate your ownership see: Verified Mark Certificates (VMC). As of 2023 this is a paid certificate for about 1500 USD a year, after registering for your trademark. So this will be kept out of scope of this page for the moment

# https://authindicators.github.io/rfc-brand-indicators-for-message-identification/
# https://mxtoolbox.com/dmarc/bimi/how-to-create-bimi-record
# https://bimigroup.org/using-the-rnc-schema-to-validate-bimi-svg-images/

==== DNS DKIM /SPF and DMARC ====
see [[Email#DKIM Setup - qpsmtpd version .3E.3D 0.96]]

====DNS CNAME Record ====
having a CNAME for autodiscover pointing to your server could help but is not mandatory.

====Server Side ====
you can list the available configuration with the following command :
config show {{#var:contribname}}

Some of the properties are not shown, but are defaulted in a template or a script. Here a more comprehensive list with default and expected values :
{| class="wikitable"
!property
!default
!values
!
|-
|DocURL
|
|string
|url on your server without the domain, to point to your local documentation about your mail service for Thunderbird like configurations.
|-
|access
|private
|private, public
|
|-
|status
|enabled
|enabled,disabled
|}

=== Uninstall ===
yum remove {{#var:smecontribname}}

=== Bugs ===
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title= bugzilla}}
and select the {{#var:smecontribname}} component or use {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=this link}}

Below is an overview of the current issues for this contrib:{{#bugzilla:columns=id,product,version,status,summary|sort=id|order=desc|component={{#var:smecontribname}} |noresultsmessage=No open bugs found.}}

===Changelog===
Only released version in smecontrib are listed here.

{{ #smechangelog: {{#var:smecontribname}} }}

===Sources===
Microsoft clients
*https://docs.microsoft.com/en-us/previous-versions/office/exchange-server-2007-technical-articles/bb332063(v=exchg.80)?redirectedfrom=MSDN#SupportedScenariosConnecting
*https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/autodiscover-for-exchange#options-for-using-autodiscover
*https://docs.microsoft.com/en-us/exchange/client-developer/web-service-reference/soap-autodiscover-web-service-reference-for-exchange?redirectedfrom=MSDN
*https://docs.microsoft.com/en-us/openspecs/exchange_server_protocols/ms-oxdscli/48d23e06-f884-44b5-993e-75b7a115827c
*https://support.microsoft.com/en-us/topic/outlook-2016-implementation-of-autodiscover-0d7b2709-958a-7249-1c87-434d257b9087
*https://admx.help/HKCU/software/policies/microsoft/office/16.0/outlook/setup
*https://www.howto-outlook.com/howto/autodiscoverconfiguration.htm
Multiple configuration
*https://github.com/mailcow/mailcow-dockerized/blob/master/data/web/autodiscover-json.php
*https://github.com/mailcow/mailcow-dockerized/blob/master/data/web/inc/vars.inc.php
*https://forum.virtualmin.com/t/autodiscover-mail-settings-outlook/108570
*https://github.com/mailcow/mailcow-dockerized/issues/615 (trouble with Outlook 2016)
*https://github.com/mailcow/mailcow-dockerized/blob/master/data/web/autodiscover.php
*https://github.com/gronke/email-autodiscover/blob/master/mail/autodiscover.xml
*https://mcmilk.de/projects/autoconfig/ (MS TB and Apple)
* https://roll.urown.net/server/mail/autoconfig.html
* https://github.com/smartlyway/email-autoconfig-php

about new MS json file
* https://blog.icewolf.ch/archive/2020/12/09/autodiscover-v2-json-requests.aspx (TODO create this file)
* https://github.com/mailcow/mailcow-dockerized/blob/master/data/web/autodiscover-json.php
* https://www.msxfaq.de/exchange/autodiscover/autodiscover_v2.htm
* https://github.com/gronke/email-autodiscover/blob/master/settings.json.sample
* https://github.com/mailcow/mailcow-dockerized/pull/636
about Mozilla

* https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat

generic

* https://datatracker.ietf.org/doc/html/rfc6764

[[Category: Contrib]]


[[contribtemplate::2| ]]

SMEServer AutoDiscover - Revision history