v132 Dovecot fails to start: sni.conf: Multiple names no longer supported in local_name value

December 10, 2025 12:31
Updated

Symptoms

Upon updating to cPanel v132, Dovecot may fail with the following error:

sni.conf: Multiple names no longer supported in local_name value

Description

Dovecot updated to version 2.4.1 in cPanel 132. Version 2.4.1 includes changes on how the local_name value is utilized, which can result in failure if multiple domains are used on the same local_name value.

We've opened an internal case for our development team to investigate this further. For reference, the case number is CPANEL-49525. Follow this article to receive an email notification when a solution is published in the product.

Workaround

Create /var/cpanel/templates/dovecotSNI/main.local
```
touch /var/cpanel/templates/dovecotSNI/main.local
```

Update the file with this data:

# DO NOT MODIFY THE NEXT LINE:
# This version of dovecot supports: wildcards, multi local_name, explict maincert local_name.

# Main cert for SNI
[% IF main_cert_domains && main_cert_domains.size -%]
[% FOREACH domain IN main_cert_domains -%]
local_name "[% domain %]" {
    ssl_server_cert_file = [% ssl_server_cert_file %]
    ssl_server_key_file = [% ssl_server_key_file %]
}

[% END -%]
[% END -%]
# END - Main cert for SNI

# Domain TLS
[% FOREACH domain_info IN mail_sni_domains -%]
[% FOREACH domain IN domain_info.cert_domains -%]
local_name "[% domain %]" {
    [%- SET cert_path = get_domain_path(domain_info.domain_tls) %]
    ssl_server_cert_file = [% cert_path %]
    ssl_server_key_file = [% cert_path %]
}
[% END -%]
[% END -%]
# End Domain TLS

Run the following command to update the configuration:
```
/scripts/builddovecotconf
```

Symptoms

Description

Workaround

Related articles