Troubleshooting SPMT installation issues

If you're having trouble installing the SharePoint Migration Tool (SPMT), review this article for information on the possible causes and how to correct them.

If after troubleshooting you still are experiencing problems, consider downloading and installing the public preview version of SPMT. It contains the latest updates and fixes.
Download SPMT Public Preview

Common issues

If you're having issues loading the SharePoint Migration tool, here are a few items that are commonly forgotten.

Item Requirement
System architecture Must be x64
.NET version Must be 4.6.2 or higher. See How to determine which versions are installed
Microsoft Visual C++ 2015 Redistributable for X64. SPMT is trying to add all the redistributions in packages, but missing some system dlls. Trying to install the package might help to resolve all the dependencies. Download: Microsoft Visual C++ Redistributable latest supported downloads.
Anti-virus Stop third party anti-virus software on your computer prior to installation.

Install errors

Error Suggested action
"Application SharePoint Migration Tool is already installed from another location". An unfinished installation may be the cause of this error. Uninstall the tool and then reinstall.

Government cloud support

If you are on a government cloud, you must first take these steps:

  1. Open %localappdata%\Apps\SharePointMigrationTool\SPMT\microsoft.sharepoint.migration.common.dll.config.

  2. Change the value of SPOEnvironmentType to:

    • 4 if you're GCC
    • 3 if you're DoD
    • 2 if you're GCC high
    • 0 if you use the Worldwide consumer cloud
  3. Double-click "microsoft.sharepoint.migrationtool.advancedapp.exe" to start SPMT.

Note

0 = Worldwide consumer cloud and GCC 2 = GCC high 3 = DoD