2.24.2.3.6. Automatic Thunderbird Configuration

In order for setting up mail in Thunderbird do not manually enter connection data, you can organize autoconfiguration... To do this, the site needs place special config file in XML format. After that, when configuring mail, the mail client will check for the presence of this file in standard locations. If the file is found, the settings will be filled in automatically and it will be enough just to select the protocol for incoming mail:

Auto-configuration file

The file contains common for all users of our mail service connection data to mailboxes: host addresses, port numbers and connection types for IMAP, POP3 and SMTP protocols. Create a file named config-v1.1.xml with content like this: 

<?xml version="1.0" encoding="UTF-8"?>
<clientConfig version="1.1">
  <emailProvider id="mail.adm.tools">
    <domain>%EMAILDOMAIN%</domain>
    <displayName>%EMAILADDRESS%</displayName>
    <displayShortName>%EMAILADDRESS%</displayShortName>
    <incomingServer type="imap">
      <hostname>mail.adm.tools</hostname>
      <port>993</port>
      <socketType>SSL</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </incomingServer>
    <incomingServer type="pop3">
      <hostname>mail.adm.tools</hostname>
      <port>995</port>
      <socketType>SSL</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </incomingServer>
    <outgoingServer type="smtp">
      <hostname>mail.adm.tools</hostname>
      <port>465</port>
      <socketType>SSL</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </outgoingServer>
  </emailProvider>
</clientConfig>

File placement

The autoconfiguration file can be placed on the main domain or subdomain autoconfig.

On the main domain

  1. Download autoconfiguration file.
  2. Through filemanager or any FTPclient place the downloaded file in root directory of the site along the way .well-known/autoconfig/mail/config-v1.1.xml... The absolute path will look like this: /home/example/example.com/www/.well-known/autoconfig/mail/config-v1.1.xml, where example — the name of your hosting account, example.com — your domain name from mailboxes.
  3. Check the availability of the file using a link like example.com/.well-known/autoconfig/mail/config-v1.1.xml, where example.com — your domain name from mailboxes.
  4. Check autoconfiguration work when setting up mail in Thunderbird.

On subdomain autoconfig

  1. Add subdomain with the title autoconfig.
  2. Download autoconfiguration file.
  3. Through filemanager or any FTPclient place the downloaded file in subdomain root autoconfig along the way mail/config-v1.1.xml... The absolute path will look like this: /home/example/example.com/autoconfig/mail/config-v1.1.xml, where example — the name of your hosting account, example.com — your domain name from mailboxes.
  4. Check the availability of the file using a link like autoconfig.example.com/mail/config-v1.1.xml, where example.com — your domain name from mailboxes.
  5. Check autoconfiguration work when setting up mail in Thunderbird.
Content