Aryson MBOX to Office 365 Migration Tool

Step 1: Download and install the Aryson MBOX Migrator Tool on your system.

Step 2: Run it as administrator and activate it using the license key (or continue with the demo version).

Step 3: Choose how you want to add the required MBOX data into the software:

• Select Profiles: Automatically detect configured Thunderbird profiles.
• Select Files: Press this button to add single or multiple MBOX files.
• Select Folder: Use it to add an entire folder that contains MBOX files.
• Remove Selected: Delete selected MBOX files from the list.
• Clear List: Clear all added MBOX files.
• Proceed: Click on the Proceed button to proceed further.
• Drag and Drop functionality: The user may add the required MBOX files using the drag-and-drop features of the software.

Step 4:Browse your system, select the required MBOX file/folder, and click Open to load them into the software.

Step 5: The loaded MBOX files appear in a structured Table of the selected data

• Sr. no.: Displays the serial number assigned to each loaded MBOX file.
• Name: Shows the name of the selected MBOX file added to the software.
• File Path: Indicates the exact location where the MBOX file is stored on the system.
• No. of Files: Displays the total number of MBOX files added for conversion or migration.
• Select All: Allows you to quickly select or deselect all listed MBOX files at once. Verify the selected files and click Next.

Step 6: Now, an Advanced Preview Panel will appear. Expand the tree-like hierarchy of the selected files and folders.

Step 7: Preview the emails and their associated attachments. The preview panel displays:

• From: Displays the sender’s email address and information for the selected email.
• To: Shows the recipient’s email address to whom the message was sent.
• Subject: Indicates the subject line of the selected email.

Step 8: You may use the other options for better filtering of MBOX data.

• Search Folders: Find specific folders by entering keywords from the folder name.
• Advanced Search: Search emails using "To," "From," or "Subject" criteria of emails.
• Open in Browser: Opens the selected email in a web browser if the preview is not displayed properly in the software.

You can also preview emails in the following:

• HTML format: Displays the email with its original formatting, including fonts, colors, and images.
• Plain text: Shows the email content in simple text without any formatting.
• Headers: Displays detailed technical header information of the email.
• MIME: Shows the MIME structure and encoding details of the message.
• Raw HTML: Displays the original HTML source code of the email message.

Step 9: Under the Export to Email Clients dropdown list, choose Microsoft 365.

Step 10: Now, you can authenticate your Microsoft account via an application credential:

10.1 By using an application credential:

• First, disable OAuth authentication by unchecking Use OAuth 2.0 Authentication.
• Additional fields will appear:
  • Microsoft 365 Admin Account
  • Application (Client) ID
  • Client Secret
  • Tenant ID
  
  

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.

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

Step 10.2: After successful authentication, the User Management window will appear, displaying all available Microsoft 365 mailboxes.

1. Select Automatic Fetch Users from the Admin ID to automatically retrieve user mailboxes associated with the authenticated Microsoft 365 tenant.
2. Alternatively, choose CSV Import if you want to import user details using a CSV file.
3. Use the Search User field to quickly locate a specific mailbox.
4. Review the list of available users, including:
   • Name
   • User ID
   • Mailbox Type
   • Validation Status
5. Select the desired mailbox(es) by checking the corresponding checkbox.
6. To select all available users, click the Select All checkbox.
7. Verify that the validation status for the selected mailboxes is displayed as allowed.
8. Click Next >> to proceed to the mailbox mapping and migration process.

Only users with allowed validation can migrate their MBOX data to Office 365 without any issues.

Import Users via CSV File

The software also provides an option to import Microsoft 365 user accounts using a CSV file. This method is useful when you want to migrate data to specific mailboxes without fetching users automatically from the admin account.

Download the Sample CSV File

1. In the User Management window, toggle on the CSV Import radio button.
2. Click the Sample CSV button to download the sample CSV template.
3. Open the downloaded file and enter the required user details in the specified format.
4. Save the CSV file after updating the mailbox information.

Demo CSV File-

Import the CSV File

1. After preparing the CSV file, click the Import CSV button.
   
2. Browse and select the updated CSV file from your system.
   
3. The software will load and validate the user details from the CSV file.
4. Successfully imported users will be displayed in the user list.

Review Imported Users

1. Once the CSV file is imported successfully, the user details will appear in the grid.
2. Review the following information for each user:
   • Name
   • User ID
   • Mailbox Type
   • Validation Status
3. Select the required users for migration.
4. Use the Select All option if you want to choose all imported users.
5. Confirm that the Validation status is displayed as Allowed for the selected mailboxes.

Step 11:The next panel displays the General Settings and Advanced Controls tabs, where you can configure the required migration options.

Step 11.1: Date Range Filter: Allows you to migrate emails within a specific date range by selecting the Start Date and End Date.

Step 11.2: Custom Output Folder: Enables you to define a custom folder name for storing migrated data.

Step 11.3: Skip Existing Exports: Prevents duplicate migration by skipping already-migrated emails.

Step 11.4: Follow Tree Hierarchy: Select this option to preserve the original MBOX folder structure during migration to Office 365. All folders and subfolders remain organized as in the source mailbox.
Map with Default Mailboxes: Choose this option to map the default folders of MBOX files to Office 365 default folders such as Inbox, Sent Items, Drafts, Deleted Items, and Junk Email.

Step 11.6: Duplicate Detection: Removes duplicate emails based on selected fields like "To," "From," "Subject," or "CC."

Step 12: Click on the Start Export button to begin the conversion process.

Step 13: After completion, the Conversion Report displays

• A pop-up: “All Selected data has been exported Successfully."
• It displays Source, Destination, File Count, Processing Status, Execution Time, Total Messages, and Output Location.

Step 14: After conversion, details:

• Start New Export: Start another conversion
• Export Log: Save the conversion report in CSV format.