This quick start guide provides you with the basic information to configure CloudMigrator for a migration from Box. It is highly recommended that you read the application documentation in full for your platforms in order to understand all of the options available to you during a migration.
It is required to perform the below using a Box ADMIN (co-admin won't work).
In order to access all data within Box, data is retrieved using the Box Content API.
Please ensure that the file content you are migrating from Box is owned by the users you wish to migrate.
Creating a Box application
- Navigate to the Developers Console and login with a Box administration account.
- If this is the first Box application to be created under the administration account, click ‘Get Started’. If you have any existing applications click Create New App.
- On the following page select Custom App, then Standard OAuth 2.0 (User Authentication).
Enter a unique name for your application and select Create Box. You should see a prompt "Woot! Your app has been created."If an application already exists within Box with the same name you will be presented with the following message ‘Application with this name already exists’. Adjust the name accordingly to make the name unique e.g. append with a random number.
- On the successful creation of the application, you will be brought to your Box Application Configuration. If not, you can easily go to My Apps/[Select your App]/Configuration from the right-hand menu.
- Scroll down to the OAuth2 parameters, depending on the application enter the following:
CloudMigrator Web :
Redirect URI: https://<domain_you're_using>/api/boxexport/callback.<domain_you're_using> will be the domain you are accessing CloudMigrator Web. If you login to CloudMigrator Web using /api/boxexport/callback
the redirect URI would be
If logging into CloudMigrator Web using you will also need follow this article HTTPS Setup for Web Installation.
- Redirect URI : https://cloudm.co/callback
- Scopes : ‘Read and Write all files and folders stored in Box’, ‘Manage Users', 'Manage Groups' and 'Manage enterprise properties'
- Perform Actions as Users : Enable
Then, simply, click Save Changes. On success you will see a confirmation message ‘Successfully updated the app’ appear at the top of the page.
Enabling Enterprise Features
After creating a Box application you will be required to email Box support to enable the following features:
- Box Notifications
- Go to the Box support area of the website and create a new ticket.
- You will be prompted to login if not already logged in. A dialog window may appear, click continue. In the support form that you now see, enter the following details:
- Subject - 'Box Notifications to be enabled'
- Description - 'Please enable the following “Box Notifications” for this application.'
- Severity - Normal
- API Key - In this field, enter the client_id you made a note of when creating a Box.com application.
- Select Box in the platform selector:
- Enter the settings into the Box server settings
- Enter your license key. Please click Help > Licence Key to apply the licence. Paste in licence key and click Apply.
- Setup your destination platform. Instructions are available for GSuite, Microsoft Exchange or Office 365.
- Test the configuration using the configuration test tool, available at ‘Tools->Check Connections’. See this article for more information about the connection test tool. You will also need to complete the settings for the destination platform before running this test. If any problems are encountered with the connection test, please examine the error and make the adjustments to your configuration settings.
- Generate your user list and select the users and items you would like to migrate in the ‘Users/Resources’ tab.
- Start your migration
CloudMigrator Web UI
If you're using CloudMigrator Web, then please take a look at this page HTTPS Setup for Web Installation for additional info.
If you have any specialized needs, or would like to learn more about the migration options and how they can be used to make sure your migration is performed in an appropriate way for your organisation, please refer to the advanced options.