| Error | Cause | Fix |
|---|---|---|
auth failed (right password) |
userdb miss | Check user_query, verify mailbox path exists |
Mailbox doesn't exist |
mail_location wrong | doveconf -n mail_location and inspect path |
UIDVALIDITY changed |
Mailbox recreated or replication conflict | Check dsync logs; restore from backup if data lost |
Permission denied: dovecot.index.log |
Wrong ownership on index/control | chown -R vmail:vmail /var/indexes |
Quota exceeded |
Quota cap hit | doveadm quota get -u user@d.com; raise quota_rule |
SSL handshake failure |
Cert expired or wrong path | openssl s_client; check renewal hook fired |
Connection refused 4190 |
ManageSieve disabled | Enable sieve in protocols = list |
LMTP timeout |
Postfix → Dovecot socket | Check /var/spool/postfix/private/dovecot-lmtp perms |
Out of memory (vsz_limit) |
Pathological client | Raise vsz_limit or kill the client connection |
fts: indexing failed |
Solr down / disk full | systemctl status solr; df -h |
Master tool list:
doveconf -n— effective configdoveadm mailbox status -u <user>— mailbox statedoveadm fetch— read messages without IMAPdoveadm log find— show recent log filesdoveadm stats dump— live metricsdoveadm director status— cluster view (with director)
Sign in to keep track of what you have read.