File Server File Shares to Dropbox Shared Folders Migration Guide

This Migration Guide provides the procedures for migrating file shares from Windows File Servers to Dropbox. If you are migrating home directories to Dropbox accounts, refer to File Server Home Directories to Dropbox Migration Guide for more information.

First migration?

We’ve created a guide on scoping, planning, and managing the migration process for your use. If this is your first migration, we recommend reading this guide carefully.


MigrationWiz is a migration tool, not a syncing tool. If changes are made at the source after migration, they will not sync to the destination, nor will changes made at the destination sync to the source. We do not have “live” monitoring of changes (as with a sync agent) and we cannot handle scenarios such as conflict resolution without user interaction.

To see what items are included in the migration, see What items are migrated with MigrationWiz? and What items are not migrated with MigrationWiz?

MigrationWiz supports the capability to share migration projects across a Workgroup. When the Project Sharing feature is turned on, all Agents besides those who are Inactive can view all migrations projects.

We are not able to support migrations with two-factor or multifactor authentication.

The maximum file size for migration through MigrationWiz varies by migration type and environment, but may never exceed 60GB.

Prepare the Azure Environment

  1. Estimate Azure storage costs. This step is optional but is useful in providing the customer with upfront storage costs ahead of time. You will need enough storage capacity to upload all of the migrating data.
  2. Buy an Azure subscription, or use the free one-month trial ( this option is only viable if you are performing a very small migration).
  3. Create an Azure storage account. We recommend that you create an Azure Storage Account in the same Microsoft data center as the Destination Microsoft 365 tenant. Leave all settings default unless otherwise specified.

To create a storage account, follow the next steps:

  1. Visit ​portal Azure.​
  2. Click Storage accounts.
  3. Click Storage Create.
  4. Select the subscription in which you want to create the new storage account.
  5. Select your Resource group.​ Create a new one if it does not exist.
  6. Enter a name for your storage account.​
  7. Choose your datacenter Location.
  8. Choose Standard performance.
  9. In the Redundancy field, select Locally Redundant Storage (LRS).
  10. Click Review.
  11. Click Create.
  12. Once the deployment shows as complete, click on Go to the resource.
  13. Select Access keys under "Security + Networking".
  14. Copy the Storage account name and the key 1. You will use this when running UploaderWiz and within the migration project.
  15. Click on Containers under "Data Storage".
  16. Create a container for each separate file server you will be uploading and make note of the name(s).

When uploading, MigrationWiz will create three metadata files, which will be added to each container. These are used during migration by MigrationWiz, to build the folder structure in the destination. They should not be deleted until after the migration.

Prepare the Destination Dropbox Environment

  1. Create a Dropbox user account that will be used for the migration, and grant team admin privileges​ to the user. Follow the instructions in the Add Tiered Admins article from Dropbox.
  2. Create the new Dropbox user accounts. Follow the instructions in the Invite your Team article from Dropbox.​ You must wait for all new users to accept their Dropbox invitations before starting the migration.​

Upload Files to Azure

Steps are performed from a file server, or a computer joined to the domain when logged in with the domain admin account, with local admin rights to the machine. This process utilizes UploaderWiz. Our guides contain information on running, configuring, and troubleshooting UploaderWiz. 

  1. Download and extract the UploaderWiz utility from here (e.g., extract into the c:\apps\uploaderwiz directory).
  2. (Optional, but recommended) Set the file shares to read-only access and inform the users that a migration is occurring and that their file shares are now read-only. This will prevent the user from adding files to these file shares during the migration.
  3. From the command console, running as administrator, from the directory that UploaderWiz was extracted into, run the following command (replace the x's with your information):
    UploaderWiz -accesskey "xxxxxxxx" -secretkey "xxxxxxxxxxxxxxxxxxxxxxx" -container xxxxxx -type azureblobs -rootpath "xxxxxxxx"


    If you are performing these steps from a domain-joined computer, a network drive needs to be mapped from the domain-joined computer to the file server (e.g. x:\File Server).  If there are spaces in the path, then it needs to be enclosed within quotation marks:

    • The AccessKey will be the name of the storage account.
    • The SecretKey will be the access key for the storage account.
    • The Container will be the name of the container you are uploading to.
    • The RootPath will be the path to the files that you want to migrate.

MigrationWiz Steps


We recommend you purchase the User Migration Bundle license for this migration scenario. User Migration Bundle licenses allow multiple migration types to be performed with a single license. They also allow DeploymentPro to be used to configure Outlook email profiles. For questions on licensing, visit MigrationWiz Licenses.

Purchase licenses by following the next steps.

  1. Sign in to your BitTitan account. 
  2. In the top navigation bar, click Purchase.
  3. Click the Select button and choose User Migration Bundle licenses.
  4. Enter the number of licenses you want to purchase. Click Buy Now.
  5. Enter a Billing address if applicable.
  6. Click Next.
  7. Review the Order Summary and enter a payment method.
  8. Click Place Your Order.

Create a Document Project

  1. Log in to MigrationWiz.
  2. Click the Go to My Projects button.
  3. Click the Create Project button.
  4. Select the Document project type. 
  5. Click Next Step.
  6. Enter a Project name and select a Customer.
  7. Click Next Step.
  8. Click on New to create a new endpoint or select an existing one from the dropdown list:
    1. Give the endpoint a name.
    2. For Endpoint Type, select Azure File System.
    3. Enter the storage account name.
    4. Enter the Access Key.
    5. Click on Add.
  9. Click Next Step.
  10. Click on New to create a new destination endpoint or select an existing one from the dropdown list:
    1. Give the endpoint a name.
    2. Select Dropbox as the endpoint type.
    3. confirm that Provide Credentials is selected.
  11. Click on Save And Go To Summary
  12. In the "Authorization" tab, click on the option to "Request Access Token" and go through the steps to sign into your Dropbox tenant.  This will generate the Token that MigrationWiz will use to connect to Dropbox
  13. Once the token has been provided, click on "Advanced Options on the left side of the screen
  14. Under the "Support" Section enter the option  InitializationTimeout=8  This increases the maximum allowed timeout window for the enumeration phase of the migration.  This is most useful for larger migrations but does not negatively impact smaller ones.
  15. Click on the Source/Destination tab.
  16. Under the Source section, update the Container Name to reflect the container that the items were uploaded to.
  17. Click on Save and then Save Project.


If you are migrating from more than one source, and are using different containers within Azure for each upload, you will need a separate project for each separate container.  You can easily create additional projects using this first one as a template by cloning it.  You would then just need to update the container in each one to reflect your desired source.

Clone the project

  1. Click the Edit Project button.
  2. Select Clone Project from the drop-down list.
  3. Enter the name for the new Project (each new project should be named after the file share name)
  4. Click the Clone Project button.

Add Items

Within the project, add the Dropbox account to migrate the files into. Select Add/Quick Add and enter the login name of the Dropbox account within the Destination field labeled "Email Address".

Apply License

Once the item has been added to the project follow the steps below to apply your license and proceeed with the migration process.

  1. Check the user's checkbox you want to apply the license.
  2. Click Apply Licenses > Apply User Migration Bundle Licenses.

This will apply the UMB license to the user. Once the "User Migration Bundle Active" column changes to Yes, you will be ready to proceed with the migration.

Run Verify Credentials


You do not need a license applied to run this step.

  1. Open the Project containing items you wish to validate.
  2. Select the items you wish to validate.
  3. Click on the Start button in your dashboard.
  4. Select Verify Credentials from the drop-down list.

Once complete, the results of the verification will be shown in the Status section.​ 

Start migration

  1. Select the users.
  2. Click the Start button from the top.
  3. Select Full Migration.
  4. Click Start Migration.

Retry Errors

If the migration fails, you will see a red Failure message in the project, clicking on this will take you to a screen that will show the error which caused it to fail.  If the Migration was successful, but certain items failed to migrate, You will also see those errors listed.  If the migration is failed, you can simply try it again after resolving whatever caused it to fail.  If it was successful but with failed items, you can run a "Retry Errors" migration pass to attempt those failed items again without running the entire migration again.

If problems persist, contact Support.

Post-Migration Steps

  1. Remove access to the Source file shares.
  2. Provide training on Dropbox.
  3. Decommission file server. Perform this step only after migrating all data from the file server, such as home directories, and you are certain that you will not be returning to the file server.
  4. Delete the Azure blob container that was created during the upload to Azure. This will prevent incurring post-migration Azure costs for this container.
  5. If preferred, you can move data from shared folders to team folders on Dropbox, and set up access permissions. Read the Shared folder differences with Dropbox Business article from Dropbox for more information.
Was this article helpful?
0 out of 0 found this helpful