52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
# Dovecot Master User
|
|
|
|
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.
|
|
|
|
iRedMail configures Dovecot to query master user accounts from config file
|
|
`/etc/dovecot/dovecot-master-users-password` (or `dovecot-master-users`) by
|
|
default, you can modify this file to add or remove master user.
|
|
|
|
The format is simple:
|
|
```
|
|
username:password
|
|
```
|
|
|
|
You can generate a password supported by Dovecot first. for example, SSHA512.
|
|
Let's generate password hash for our password `my_master_password`:
|
|
```
|
|
# doveadm pw -s SSHA512
|
|
Enter new password: my_master_password
|
|
Retype new password: my_master_password
|
|
{SSHA512}B0VHomJaMk6aLXOPglgNgJtCUA8JRnOweAwJxRW6NPWSNZ25rG/L6T05DJXH+t8WCQkemBilgkcEi6mq4Kadssivtts=
|
|
```
|
|
|
|
You can now pick up any username you like, for example, `my_master_user`.
|
|
Now add new master user in file
|
|
`/etc/dovecot/dovecot-master-users-passwords` like below:
|
|
|
|
```
|
|
my_master_user:{SSHA512}B0VHomJaMk6aLXOPglgNgJtCU...
|
|
```
|
|
|
|
WARNING: Make sure file `dovecot-master-users-password` is owned by Dovecot
|
|
daemon user and group, with file permission `0500`, so that others cannot view
|
|
the file content.
|
|
|
|
> * on Linux/FreeBSD, Dovecot daemon user/group is `dovecot/dovecot`.
|
|
> * on OpenBSD, Dovecot daemon user/group is `_dovecot/_dovecot`.
|
|
|
|
Then you can access user@domain.ltd's mailbox (via either IMAP or POP3
|
|
protocol) as `user@domain.ltd*my_master_user` with password
|
|
`my_master_password`.
|
|
|
|
## Troubleshooting
|
|
|
|
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:
|
|
|
|
* [Debug Dovecot](./debug.dovecot.html)
|
|
* [iRedMail online support forum](http://www.iredmail.org/forum/)
|