Cloudron makes it easy to run web apps like WordPress, Nextcloud, GitLab on your server. Find out more or install now.

email: autoconfig for autoconfiguration (example: via thunderbird)

  • Hi guys, I'm a standard cloudron subscription user.

    I've just set up emails using cloudron everything worked perfectly. I had to setup email server and experienced the pain it can be to have everything working smoothly and secure. Thank you so much for taking car of all the hassle with the cloudron, it's amazing 🙂

    Question: I'm using Thunderbird and it was not able to automatically detect cloudron settings, I had to set it up manually. i'm tech savvy so it's fine by me, it won't be the same though for family and friends.

    Is there any chance that you would add autoconfig to the email part of cloudron so that thunderbird (and equivalent mail client) would automatically find the configuration?

  • Staff

    This is in our TODO list: . I have added @subven suggestion there now.

  • Understood thanks a lot!

  • I had autoconfig setup for business emails before cloudron. Here is the process I used:

    Let's say you have the following domains: The domain for which you want to have email autoconfig The URL of your cloudron server that manages your email and will broadcast the autoconfig configuration.

    setup DNS entries in the DNS

    // entry for outlook (never tested since I only use thunderbird)
    _autodiscover._tcp 600 IN SRV 0 0 443
    // entry for thunderbird and others
    autoconfig 600 IN CNAME
    smtp 600 IN CNAME
    imap 600 IN CNAME

    // does not need an SSL certificate
    //, must have an active SSL certificate

    Create the mail directory and autoconfig file

    in the webroot for create the file


    Content of mail/config-v1.1.xml

    // Here is a sample:

    <?xml version="1.0" encoding="UTF-8"?>
    <clientConfig version="1.1">
      <emailProvider id="">
        <incomingServer type="imap">
        <outgoingServer type="smtp">

    Nginx config

    since autoconfig does not require any SSL certificate you can setup any autoconfig request to match the same config file. For cloudron it might be better to have one config file per domain?

    server {
      listen 80;
      root /var/www/;
      access_log /var/log/nginx/;
      error_log /var/log/nginx/ warn;
      location / {
        try_files $uri $uri/;

    Aside note

    in theory you should be able to not use and, in practice though, I had trouble with thunderbird not recognizing the autoconfig without those 2 domains setup (it was 1 year ago, maybe it changed since)

    Hope it helps! I'll be happy to assist implementing if interested 😉

Log in to reply