Let's face it -- having to reset the users' password when doing an e-mail migration is a big pain-point. End-users don't like having their passwords changed, and the tech-folks don't like the storm of support calls from frustrated users who can't get to their email. That is on top of the issues that might arise when users changes their password from the password the admin changed it to mid-migration.
All in all, it's a pain. Luckily, there are ways around this for some email services and servers. Dovecot is one of them. Unfortunately Dovecot isn't configured to support this by default (in most systems), but in this article we'll tell you how to enable it.

Configuring Dovecot


The trick is to create a master-user and set "auth_master_user_separator". This page on Dovecot's wiki walks you through the process.
Once you've configured this, you should be able to authenticate to any user's mailbox using the master-user. To verify that you can login, open a connection to your IMAP-server.

$ openssl s_client -crlf -connect mail.server.com:993

You should now be able to login to any user's account using the master-user. For instance, if we want to login to the user 'foobar' using the admin account 'admin' with the password 'myPass', we would enter:

. LOGIN "foobar*admin" myPass

(we also assume that auth_master_user_separator is set to "*")

Using YippieMove


Luckily, the hard part is over. Using the master-user to authenticate against a Dovecot server in YippieMove is really easy and it works both for single-user migrations as well as batch migrations.
All you need to do is to append "*master-user" to the end of the username, and use the master user-password. Again, if the example above wasn't clear. If you want to connect to the IMAP account 'jdoe', and your master user is 'admin', you'd use 'jdoe*admin' as the username in YippieMove, along with the password for 'admin'.
Click here to get started.
Got any questions? Let us know.