Environment:
Panel Version: 2.10.1
Operating System: Debian 13 (Trixie)
Plugin: Mail Server (latest version)
Application: Dovecot
Problem Description:
After a fresh installation of the Mail Server plugin on a clean Debian 13 server, the Dovecot service fails to start. The default configuration files generated by the aaPanel plugin are incompatible with the version of Dovecot shipped with Debian 13, leading to a series of fatal errors.
Summary of Configuration Errors and Manual Fixes:
The default configuration had to be manually patched in multiple locations to get the service running. The following errors were encountered and resolved in sequence:
Missing dovecot_config_version:
Error: doveconf: Fatal: The first setting must be dovecot_config_version
File: /etc/dovecot/dovecot.conf
Fix: Added dovecot_config_version = 3 to the top of the file.
Missing dovecot_storage_version:
Error: doveconf: Fatal: dovecot_storage_version setting must be set
File: /etc/dovecot/dovecot.conf
Fix: Added dovecot_storage_version = 2.3 to the file.
Invalid dict Section:
Error: doveconf: Fatal: dict { } is missing section name
File: /etc/dovecot/dovecot.conf
Fix: Commented out the entire empty dict {} block.
Unknown Setting disable_plaintext_auth:
Error: doveconf: Fatal: Unknown setting: disable_plaintext_auth
File: /etc/dovecot/conf.d/10-auth.conf
Fix: Commented out the line disable_plaintext_auth = yes.
Unknown SSL Settings (ssl_cert & ssl_key):
Error: doveconf: Fatal: Unknown setting: ssl_cert and ssl_key
File: /etc/dovecot/conf.d/10-ssl.conf
Fix: Modified the SSL path syntax from ssl_cert = /path to ssl_cert = </path>. This had to be done for both ssl_cert and ssl_key.
Missing LMTP Service Binary:
Error: Fatal: service(lmtp) access(/usr/lib/dovecot/lmtp) failed: No such file or directory
Fix: The dovecot-lmtpd package was not installed as a dependency. Manually installed it with apt install dovecot-lmtpd.
Incorrect File Permissions for SSL Certificates:
Error: doveconf: Fatal: Can't open file /path/to/cert.pem
Cause: SSL certificates were owned by root:root with 600 permissions, making them unreadable by the Dovecot process.
Fix: Changed file ownership to root:dovecot and permissions to 640.
Recommendation:
The Mail Server plugin needs to be updated to:
Generate Dovecot configuration files that are compliant with the syntax used in Debian 13.
Ensure dovecot-lmtpd is included as a necessary dependency during installation.
Set the correct file permissions on SSL certificates so they are accessible by the Dovecot service.
Thank you for your attention to this matter.