Step 1: Install the SharePoint Migration Tool (SPMT)

Download and install

Download and install SPMT using one of the links listed below.

Before you begin

Before you begin using SPMT, review the required permissions, prerequisites, and endpoints.

Understanding Custom scripts

Allow or prevent Custom Script (NoScript)

In Microsoft 365, tenants can control if users can run custom script on personal sites and self-service created sites.

During migration, some web parts require this setting set to allow. Otherwise, the web part won't be migrated.

At least 24 hours before you start migration, do the following:

1. Go to Settings in the SharePoint admin center, and sign in with an account that has admin permissions for your organization.

2. At the bottom of the page, select classic settings page.

3. Under Custom Script, select:

   Allow users to run custom script on personal sites
   Allow users to run customer script on self-service created sites

   Leave these settings in place during your migration.

   Note

   Changes to this setting might take up to 24 hours to take effect.

   For more info, see, Allow or prevent custom script.

Proxy connections

Proxy connections aren't supported for either SharePoint or file share migrations. By default, SPMT doesn't use system proxy credentials and web requests fail if Internet Explorer proxy is configured. Examples of errors you may see include "SharePoint sign in fail" or "can't load document library". However, you can modify the SPMT app config file to follow your system proxy settings.

If you wish to use your system proxy settings, use one of these methods:

Update proxy

1. Download the latest version of SPMT. Start SPMT.

2. If SPMT doesn't connect to Microsoft 365, go to %localappdata%\Apps\SharePointMigrationTool\SPMT.

3. Open the microsoft.sharepoint.migrationtool.advancedapp.exe.config file.

4. Uncomment the default proxy setting shown here:

5. Restart SPMT.

If SPMT doesn't upgrade

1. If SPMT can't upgrade itself, go to %localappdata%\Apps\SharePointMigrationTool\InstallerClient.

2. Open the installclient.exe.config file.

3. Add the following configuration at line 31, just after the <appSettings></appSettings tag:
   

   

4. Launch installclient.exe and SPMT should autoupgrade to latest SPMT release.

5. Open the microsoft.sharepoint.migrationtool.advancedapp.exe.config file.

6. Comment out the default proxy setting:

   

7. Restart SPMT.
   
   

Step 2: Scan and assess a SharePoint site (site migration only)