2014-12-18 07:41:54 -06:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > Dovecot Master User< / title >
< link href = "./css/markdown.css" rel = "stylesheet" > < / head >
< / head >
< body >
< div id = "navigation" >
< a href = "http://www.iredmail.org" target = "_blank" > iRedMail web site< / a >
// < a href = "./index.html" > Document Index< / a >
< / div > < h1 id = "dovecot-master-user" > Dovecot Master User< / h1 >
< p > iRedMail-0.8.6 and later releases have Dovecot Master User enabled for all
backends (OpenLDAP, MySQL/MariaDB, PostgreSQL) by default, what you need to do
is adding new master user.< / p >
< p > iRedMail configures Dovecot to query master user accounts from config file
< code > /etc/dovecot/dovecot-master-users-password< / code > (or < code > dovecot-master-users< / code > ) by
default, you can modify this file to add or remove master user.< / p >
< p > The format is simple:< / p >
< pre > < code > username:password
< / code > < / pre >
< p > You can generate a password supported by Dovecot first. for example, SSHA512.
Let's generate password hash for our password < code > my_master_password< / code > :< / p >
< pre > < code > # doveadm pw -s SSHA512
Enter new password: my_master_password
Retype new password: my_master_password
{SSHA512}B0VHomJaMk6aLXOPglgNgJtCUA8JRnOweAwJxRW6NPWSNZ25rG/L6T05DJXH+t8WCQkemBilgkcEi6mq4Kadssivtts=
< / code > < / pre >
2015-02-18 03:37:41 -06:00
< p > You can now pick up any username you like, for example, < code > my_master_user< / code > .
Now add new master user in file
2014-12-18 07:41:54 -06:00
< code > /etc/dovecot/dovecot-master-users-passwords< / code > like below:< / p >
2015-02-18 03:37:41 -06:00
< pre > < code > my_master_user:{SSHA512}B0VHomJaMk6aLXOPglgNgJtCU...
2014-12-18 07:41:54 -06:00
< / code > < / pre >
< p > WARNING: Make sure file < code > dovecot-master-users-password< / code > is owned by Dovecot
daemon user and group, with file permission < code > 0500< / code > , so that others cannot view
the file content.< / p >
< blockquote >
< ul >
< li > on Linux/FreeBSD, Dovecot daemon user/group is < code > dovecot/dovecot< / code > .< / li >
< li > on OpenBSD, Dovecot daemon user/group is < code > _dovecot/_dovecot< / code > .< / li >
< / ul >
< / blockquote >
< p > Then you can access user@domain.ltd's mailbox (via either IMAP or POP3
2015-02-18 03:37:41 -06:00
protocol) as < code > user@domain.ltd*my_master_user< / code > with password
2014-12-18 07:41:54 -06:00
< code > my_master_password< / code > .< / p >
< h2 id = "troubleshooting" > Troubleshooting< / h2 >
< p > If it doesn't work for you, please enable debug mode in Dovecot and check
its log file. If you don't understand what the log says, please create a new
topic in our forum and paste related log:< / p >
< ul >
< li > < a href = "./debug.dovecot.html" > Debug Dovecot< / a > < / li >
< li > < a href = "http://www.iredmail.org/forum/" > iRedMail online support forum< / a > < / li >
2015-02-05 07:02:53 -06:00
< / ul > < p style = "text-align: center; color: grey;" > Document published under a < a href = "http://creativecommons.org/licenses/by-nd/3.0/us/" target = "_blank" > CC BY-ND 3.0< / a > license. If you found something wrong, please do < a href = "http://www.iredmail.org/contact.html" > contact us< / a > to fix it.< script >
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
2014-12-18 07:41:54 -06:00
< / script >
< / body > < / html >