Software Guide of Aryson Thunderbird Backup Tool

Step 5: Select the Destination Client

Mark the Email Clients radio button and select Microsoft 365 as the Destination Client.

Step 6: Authenticate the Microsoft 365 Account

Choose either Method A or Method B to authenticate the active Microsoft 365 account using valid login credentials.

1. Use OAuth 2.0 authentication

1. Enter your Microsoft admin account email and click on Authenticate.

2. Log In To Your Account

1. Select an Account
   • In the Pick an account window, click the Microsoft account you want to use.
   • Alternatively, select 'Use another account' if your account is not listed.
2. Provide your password and click Sign in.
3. Approve Multi-Factor Authentication (MFA)
   • If prompted, open the Microsoft Authenticator app on your mobile device.
   • Approve the sign-in request.
   • If a matching number is displayed (e.g., 53 ), enter that number in the Authenticator app and approve the request.
4. Authentication Successful
   • Once verification is completed, a confirmation message will appear: "Authentication complete. You can close the browser and return to the application."
   • Close the browser window.

Note: While selecting the Office 365 account in the browser window, make sure you have already logged in to the required account before.

Note: Sign in to the required Microsoft 365 account in your browser before starting the migration. If multiple browser windows are open with different accounts, use the one where the required Microsoft ID is already logged in, as authentication will proceed only in that browser.

2. Authenticate Using Application Credentials

1. Turn off the Use OAuth 2.0 Authentication option.
2. Provide the Microsoft 365 Admin Account, Application (Client) ID, Client Secret, and Tenant ID to establish and authenticate the connection.

Enter Azure Application Details

Fill in the following information from your Azure app registration:

If you choose Application Credentials Authentication (Client ID, Client Secret, and Tenant ID), you must first create an Azure App Registration and assign the required API permissions in Microsoft Entra ID (Azure AD).

For complete instructions on creating the Azure Active Directory application and enabling API permissions, visit:

Create Azure Active Directory and Enable API Permission Guide

In the guide at step 17, you need to add the required API permissions. The image below lists all the API permissions that must be configured for successful authentication and migration.

3. After generating the credentials, fill in the required fields and click on Authenticate.

B.1: Select Mailbox Mapping Mode

Choose how to map the source files to the destination Microsoft 365 mailboxes.

• Migrate All Files to Selected Mailbox(es): Import all selected files into the specified Microsoft 365 mailbox(es).
• Map Each File to Specific Mailbox(es): Assign individual source files to their respective Microsoft 365 destination mailboxes.
• Next: Select the required mapping option and click Next to proceed with mailbox mapping and migration.

B 1.1: Migrate Files to Selected Mailboxes

• Fetch Users Automatically: Retrieve all available mailboxes from the authenticated Microsoft 365 tenant.
• Import via CSV: Optionally upload a CSV file to add specific destination mailbox users.
• Search Mailboxes: Use the search function to quickly locate a specific mailbox.
• Verify User Information: Review the name, user ID, mailbox type, and validation status of each mailbox.
• Select Destination Mailboxes: Select the required mailboxes individually or use Select All.
• Check Validation Status: Confirm that the selected mailboxes show Allowed status before proceeding.
• Proceed: Click Next to continue to mailbox mapping and start the migration configuration.

Note:

• Allowed indicates a licensed and valid mailbox, while Denied indicates a non-licensed or invalid mailbox.
• Mailbox types may include User Mailbox and Shared Mailbox
• Only mailboxes with Allowed status can be selected as migration destinations.

Import Users via CSV

1. Enable CSV import and download the sample CSV template.
2. Enter mailbox details in the required format and save the file.
3. Click Import CSV and browse to the updated CSV file.
4. Review the imported users and verify their validation status.
5. Select the required mailboxes and click Next to continue.

B.1.2: Map Each File to the Appropriate Mailbox(es)

1. Verify Source Folders: Review the folders listed under Source Folder and confirm that all required mailbox data has been loaded successfully.
2. Assign Target Mailboxes: Click the -- Select Target Mailboxes -- dropdown corresponding to each source folder and assign the appropriate destination mailbox.
   • Select the required Microsoft 365 target mailbox from the available list.
   • Use Search Users to locate a specific destination mailbox quickly.
   • Verify the mailbox UPN and mailbox type before assigning it.
   • Confirm that the selected mailboxes are licensed and migration-ready.
   • Use Select All to assign multiple mailboxes simultaneously.
   • Review the mailbox counts under All, Licensed, and Unlicensed for validation.
   • Click Apply to save the mailbox mappings.
3. Select Folders: Use the checkboxes on the right to select or deselect folders for migration. Use Select All to include all available folders.
4. Import Mapping via CSV (Optional): Select CSV Import to upload a predefined mailbox-mapping file when migrating multiple user profiles in a single operation.

5. Save and Migrate: Click Save Mapping & Start >> to lock in your folder configuration and begin the migration process.

Step 7: Configure General Migration Settings

• Date Range Filter: Migrate emails within a specified date range.
• Custom Output Folder: Specify a custom name for the destination folder, if required.
• Skip Existing Exports: Avoid migrating items that already exist at the destination.
• Follow Tree Hierarchy: Maintain the original Thunderbird folder structure in Microsoft 365.
• Mapped with Default Mailboxes: Automatically maps standard Thunderbird folders such as Inbox, Sent, Drafts, and Deleted Items to their corresponding default mailboxes in Microsoft 365. This will help you maintain proper folder organization during migration.

Note: The Mapped with Default Mailboxes option works only when there are Google Takeout folders present in the Thunderbird Local Folders.

Step 8: Configure Advanced Migration Controls

• Duplicate Detection: Detect and skip duplicate emails using fields such as To, From, Subject, Body, or CC.

Step 9: Click on Start Export to begin the Thunderbird to Microsoft 365 migration with the selected advanced settings.

Step 10: Monitor Thunderbird Mailbox Export Progress

• Source: Displays the selected Thunderbird MBOX mailbox being exported.
• Destination: Shows the chosen destination email client.
• File Count: Indicates the number of Thunderbird mailbox files being processed.
• Processing Status: Shows the current export status of the selected Thunderbird data.
• Execution Time: Displays the total time taken for the export process.
• Total Messages: Shows the number of Thunderbird emails being exported.
• Output Location: Displays the destination folder where the exported Thunderbird data is saved.
• Progress Bar: Tracks the real-time progress of the Thunderbird mailbox export.
• Live Processing Log: Shows the currently exporting email along with the processed message count.
• Stop Process: Allows you to stop the Thunderbird export operation if needed.

Step 11: Post-Migration Options

• Export Log: Opens the detailed export report containing migration activities, status updates, and export results for review or auditing.
• Start New Export: Resets the current session and allows you to begin a new Thunderbird mailbox export with different files or settings.

Step 5: Mark the Export to Email Clients radio button and select IMAP as the destination.

Step 6: Configure the IMAP Server and Authenticate

1. Provide the destination email address.
2. Enter the app password or mailbox password.
3. Specify the IMAP Server Host and IMAP Port Number.
4. Click on the Server List option to fetch supported IMAP server details automatically.
   • Select the IMAP host as desired or search for a specific one and click Continue.

5. Enable Show Credentials to verify the entered password.
6. Click Authenticate to validate the mailbox connection and proceed with the migration.

Step 7: Configure Additional Settings

1. Date Range Filter: Select a specific date range to convert only the required emails from the Thunderbird mailbox.
2. Custom Output Folder: Specify a name for the destination folder.
3. Skip Existing Items: Skip Thunderbird emails that have already been converted or exported to avoid processing the same mailbox data again.

2. Configure Advanced Thunderbird Conversion Options

• Attachment Handling: Choose whether to embed attachments or exclude them while converting emails from Thunderbird MBOX files.
• Duplicate Detection: Detect and skip duplicate Thunderbird emails based on To, From, Subject, Body, and CC fields.

Step 8: Click on the Start Export button to begin the Thunderbird to IMAP migration.

Step 9: Monitor and Complete the Thunderbird to IMAP Migration

After clicking Start Export, monitor the Thunderbird-to-IMAP migration progress and review the transfer statistics in real time.

• Source Thunderbird Mailbox: Verify the selected Thunderbird MBOX file or mailbox being migrated.
• Target IMAP Account: Confirm the destination IMAP email account selected for migration.
• Mailbox Items Processed: Track the number of Thunderbird emails and folders being uploaded to the IMAP server.
• Migration Status: Monitor the current status of the Thunderbird-to-IMAP migration.
• Execution Time: View the total time taken to migrate the selected Thunderbird mailbox data.
• Total Messages: Check the number of Thunderbird emails successfully migrated to the IMAP account.
• Target Mailbox: Verify the IMAP folder where the migrated Thunderbird emails are being placed.
• Progress Bar: Monitor the overall migration progress in real time.
• Stop Migration: Stop the Thunderbird-to-IMAP migration process if required.

Step 10: Verify the Thunderbird to IMAP Migration Results

Once the migration is completed, the software displays the message “All selected data has been exported successfully.” You can then review the migration results or start another Thunderbird-to-IMAP migration task.

• Migration Log: Open the detailed log report to review the migration status, processed Thunderbird emails, folders, and transfer results.
• Start New Migration: Initiate another Thunderbird-to-IMAP migration task as required.

Step 5: Select Google Workspace under the Export to Email Clients drop-down list.

Step 6: Authenticate your Google Workspace Account

Log in via the Workspace admin account and JSON key, and click Authenticate.

You can generate a JSON file with the help of the detailed guide.

Step 7: Map Source Files to Google Workspace User Accounts

Associate the selected source file with the corresponding Google Workspace mailbox before starting the migration.

1. Select the imported source file from the mapping list.
2. Click Select Directory Users and choose the target Google Workspace user account.
   • Search or select the required User ID to map and click Apply.

3. Alternatively, you can import a CSV file for bulk user mapping.

• Click on the Sample CSV button to save a demo CSV file.
• Afterwards, click on the Import CSV button to import the saved CSV file.

• Click ok and click on Select CSV users.
• Select the required user IDs of the users and click Apply.

Step 8: Configure Migration Settings

Configure the available settings to control the Thunderbird migration.

1. Apply General Filters:

• Date Range Filter: Convert Thunderbird emails within a specified start and end date.
• Custom Output Folder: Set a particular name for the resultant folder.
• Skip Existing Exports: Prevent Thunderbird emails that have already been processed from being migrated again during subsequent migration tasks.
• Preserve Folder Tree Hierarchy: Maintain the original Thunderbird folder and subfolder structure in the Google Workspace mailbox.
• Map Default Folders: Automatically map standard Thunderbird folders, such as Inbox, Sent, Drafts, and Deleted Items, to their corresponding default folders in the Google Workspace destination.

Note: The Mapped with Default Mailboxes option works only when there are Google Takeout folders present in the Thunderbird Local Folders.

2. Apply the Advanced Filters:

• Attachment Handling: Choose whether to include or exclude email attachments during conversion.
• Duplicate Detection: Identify and skip duplicate emails based on criteria such as To, From, Subject, Body, and CC.

Step 9: Click on the Start Export button to begin the Thunderbird to Google Worekspace migration.

Step 10: Monitor Thunderbird to Google Workspace Migration Progress

Once the migration is completed, the software displays the message “All selected data has been exported successfully.” You can then review the migration results or start another Thunderbird-to-IMAP migration task.

• Source Thunderbird Mailbox: Displays the selected Thunderbird mailbox or MBOX file being migrated.
• Destination Google Workspace Account: Shows the Google Workspace account selected as the migration destination.
• File Count: Indicates the number of Thunderbird mailbox files being processed.
• Processing Status: Shows the current migration status of the selected Thunderbird data.
• Execution Time: Displays the total time taken for the migration process.
• Total Messages: Shows the number of Thunderbird emails being migrated to Google Workspace.
• Migrated Items: Tracks the number of mailbox items successfully transferred to the destination Google Workspace account.
• Progress Bar: Displays the real-time progress of the Thunderbird to Google Workspace migration.
• Live Processing Log: Shows the email currently being migrated along with the number of messages processed.
• Stop Migration: Allows you to stop the Thunderbird to Google Workspace migration when required.

Step 11: Post-Migration Options

• Export Log: Opens the detailed export report containing migration activities, status updates, and export results for review or auditing.
• Start New Export: Resets the current session and allows you to begin a new Thunderbird mailbox export with different files or settings.

Step 5: Select Gmail (App Authentication) or Gmail (OAuth 2.0) under the Export to Email Clients drop-down list.

Step 6: Authenticate the Gmail Account

Step 6.1: For Gmail App Authentication:

1. Enter the target Gmail email address, OAuth Client ID, and OAuth Client Secret. You can create a Google Client ID and Client Secret using the Google Developers Console.
2. Click Authenticate to securely authorise the target Gmail account and proceed with the Thunderbird-to-Gmail migration.

Note: Make sure to first sign in to the target Gmail account in your browser and complete the required authentication. Otherwise, the migration process may not continue.

Step 6.2: For Gmail OAuth 2.0:

1. Enter the Gmail email address and click on the Authenticate button.

2. Select the required Gmail account as per the requirement or click on the 'Use another account' option to add another account.

3. Click Continue to provide access to your data, agree to the privacy policy, and proceed further.

4. After authentication, the browser window displays "Received verification code. You may close this window."

Step 7: Configure Migration Settings

Step 7.1: Apply the General Features

• Date Range Filter: Select a specific date range to migrate only the required emails.
• Custom Output Folder: Set a name for the resultant folder.
• Skip Existing Exports: Skip previously exported items to avoid duplicate processing.
• Follow Tree Hierarchy: Preserve the original Thunderbird folder hierarchy during migration.
• Mapped with Default Mailboxes: Map Thunderbird folders to the corresponding default mailboxes in the Gmail account.

Note: The Mapped with Default Mailboxes option works only when there are Google Takeout folders present in the Thunderbird Local Folders.

Step 7.2: Apply the Advanced Filters

• Duplicate Detection: Identify and skip duplicate emails based on To, From, Body, Subject, and CC fields to prevent redundant migration.

Step 8: Click on the Start Export button to begin the Thunderbird to Gmail migration.

Step 9: Monitor and Complete the Thunderbird to Gmail Migration

After clicking Start Export, monitor the Thunderbird-to-Gmail migration progress and review the transfer statistics in real time.

• Source Thunderbird Mailbox: Verify the selected Thunderbird MBOX mailbox being migrated.
• Target Gmail Account: Confirm the destination Gmail account receiving the migrated Thunderbird data.
• Mailbox Items Processed: Track the number of Thunderbird emails and folders being migrated.
• Migration Status: View the current status of the Thunderbird-to-Gmail migration.
• Execution Time: Monitor the total time taken to complete the migration.
• Total Messages: Check the number of Thunderbird emails migrated successfully to Gmail.
• Target Mailbox: Verify the Gmail mailbox and folders receiving the migrated emails.
• Progress Bar: Follow the overall Thunderbird-to-Gmail migration progress in real time.
• Stop Migration: Stop the migration process if required.

Step 10: Verify the Thunderbird to Gmail Migration Results

Once the migration is completed, the software displays “All selected data has been exported successfully.” You can then use the available options to review the migration results or start another task.

• Migration Log: Open the detailed log report to verify the Thunderbird-to-Gmail migration status, processed emails, and transfer results.
• Start New Migration: Begin another Thunderbird-to-Gmail migration task if required.