Connecting to a source IMAP server
Once the installation of CodeTwo Office 365 Migration is finished, you have to choose a source environment from which the data will be pulled and migrated to selected mailboxes in target Office 365. This article describes how to connect to a source IMAP server.
You must be aware that to migrate via IMAP you need to have credentials in hand for all accounts you are about to migrate. In one of the further configuration steps you will be asked to provide them in a form of a CSV file. It is not possible to provide only a whole organization administrator's credentials to access other users' mailboxes via IMAP due to the IMAP protocol limitations.
Configure your IMAP source
All IMAP accounts are supported - especially those hosted by well-known free mail providers such as Google or Yahoo. However, some providers have IMAP protocol disabled by default and you have to enable it manually prior to migration. Other restrictions may also apply, please refer to your mail provider for details on how to allow IMAP access. Click a link below to learn more:
Migrate from Google
One of the most popular free as well as paid email accounts provider is Google with their Gmail service. Follow the steps below to be able to migrate from Google via IMAP:
- Sign in to your Google account (whether Gmail or Google Workspace [formerly G Suite]) and go to Security in the navigation menu on the left.
- In the How you sign in to Google section, click 2-Step Verification and use the wizard to enable the 2-step verification.
- Now, click 2-Step Verification again, scroll down to the very bottom of the page, and click App passwords. Alternatively, you can use this direct link: https://myaccount.google.com/apppasswords.
- Click Select app and choose Other (Custom name). Type in your custom app name (e.g. CodeTwo Office 365 Migration) and click GENERATE. Your password (16-character code) appears in a new window. Copy the password so that it can be used when configuring an IMAP migration job, then select DONE.
Repeat steps 1-4 for each migrated mailbox separately.
- Now, go to your mail account Settings > Forwarding and POP/IMAP. Again, you can use the direct link: https://mail.google.com/mail/u/0/#settings/fwdandpop.
- In the IMAP Access section, select the Enable IMAP option and click Save Changes.
- Go to the Labels tab and select the Show in IMAP checkboxes next to the names of labels you want to migrate.
If you do not enable the Show in IMAP option, items with such labels will not be migrated, unless they happen to be labeled twice or more and those other labels are made visible via IMAP.
- Google Workspace only: using the admin account, sign in to Google Admin console, and go to Apps > Google Workspace > Gmail > Advanced settings. In the Organizations section select your organizational unit. Finally, next to POP and IMAP Access clear the Disable POP and IMAP access for all users checkbox.
More info on labels
Google's Labels are visible as folders when accessing via IMAP. Therefore, after migrating via IMAP, you can have as many folders in the target mailbox as many labels you have in your Google account. For example, if you select the Show in IMAP option for 3 labels, as described in point 6 above, you will have 3 additional folders in the target mailbox, named as these labels.
Items that are labeled with multiple labels will be migrated to each of the corresponding target folders. For example, if one of your emails is labeled as Important and Starred, and for both these labels the Show in IMAP option is enabled, after the migration you will find two copies of this email in your target mailbox: in the Important folder as well as in the Starred folder.
Migrate from other IMAP sources
Pretty much any mail server is supported as a source of migration, providing that IMAP access is enabled and you are able to provide a list of credentials to access users' mailboxes. However, see the below notes for a few most popular mail services:
- GoDaddy - if you use the old Workspace Email offer and would like to enable IMAP access, you need to switch to the Unlimited Email Plan. Learn more
- Zimbra - IMAP/POP Proxy must be configured first.
- IBM Notes - Domino IMAP Service must be configured first.
Migrate from Exchange
- If you are going to migrate from on-premises Microsoft Exchange Server, configure an EWS connection (Exchange 2010 SP1 or newer) or a MAPI connection (Exchange 2010 without SP1).
- If you are going to migrate from hosted Microsoft Exchange Server 2010 or newer, configure an EWS connection, as described here.
That way, you will be able to migrate entire mailboxes, and not emails only (one of the IMAP’s limitations).
If you don’t have the necessary permissions to migrate from an Exchange server by using EWS or MAPI. configure your source environment as described below.
Migration from Microsoft Exchange Server via IMAP might be a useful option for clients using hosted (e.g. Rackspace) or otherwise limited access Exchange Server. Before starting CodeTwo software configuration, make sure you have enabled IMAP4 in your Exchange:
Configure the software
You can create a new source connection when you configure a migration job: click Create a new migration job on the How to start card (see Fig. 1.) and select IMAP server. Then type the name of your job, and proceed to the Source mailboxes step. Select Add new source connection from the Source server list to open the source server connection wizard. You can also start the wizard by clicking the Settings () button on the Defined source server connections card (Fig. 1.) and choosing New > IMAP server connection.
|Fig. 1. How to open the source connection wizard.|
Either way, the IMAP source server connection wizard will open (Fig. 2.).
Fig. 2. Configuring IMAP connection.
In the first step (Server connection) you need to provide the following information to configure IMAP connection:
- IMAP server - you can use either IP address or its network name (e.g. imap.server.com). For your convenience, we have added the most popular IMAP servers' addresses, including Gmail, Yahoo, Outlook.com and more.
- TCP port - under which the IMAP server is running on the server. Usually, it is 993 for encrypted connections (SSL) and 143 for non-encrypted ones.
- Secure connection - this option lets you decide if the connection should be encrypted.
Be advised, for mailboxes hosted in Google Workspace with your custom domain you need to choose the same settings as for free Gmail accounts.
We strongly recommend using only encrypted (SSL) connections for your data safety. If you are not able to establish SSL connection to public IMAP servers (like Google or Yahoo), please check date and time in your system, as most probably there is an issue with SSL certificate. If still no joy, please contact your mail hosting provider.
Click Next to continue to the Throttling step (Fig. 3.). Here you can define how the program should limit connections to your IMAP server. Thanks to this feature, the program can suspend migration of mailboxes that exceeded server-side defined limits (if there are any) and continue the process for rest of them.
Fig. 3. Configuring IMAP throttling.
Proceed by clicking Next, and finally click Configure, so the application will attempt to connect to the desired server. If the setup is successful (Fig. 4.), you are good to go and create a new IMAP job.
Fig. 4. Verification of IMAP connection.
When you complete the wizard, the new connection should be displayed on the Defined server connections card (Fig. 5.).
|Fig. 5. Defined source server connections.|
Configuring source mailboxes for IMAP connection