Troubleshoot Visual Studio 2017 installation and upgrade issues
Having a problem installing? We can help. We offer a live chat (English only) support option.
This troubleshooting guide includes step-by-step instructions that should resolve most installation issues.
How to troubleshoot an online installation
The following steps are optimized for a typical online installation. For an issue that affects an offline installation, please see How to troubleshoot an offline installation.
Step 1 - Check whether this problem is a known issue
There are some known issues with the Visual Studio Installer that Microsoft is working on fixing. To see if there's a workaround for your problem, check the Known Issues section of our release notes.
Step 2 - Check with the developer community
Search on your error message with the Visual Studio Developer Community. Other members of the community might have documented a solution to your problem.
Step 3 - Delete the Visual Studio Installer directory to fix upgrade problems
The Visual Studio Installer bootstrapper is a minimal light-weight executable that installs the rest of the Visual Studio Installer. Deleting Visual Studio Installer files and then rerunning the bootstrapper might solve some update failures.
Performing the following actions reinstalls the Visual Studio Installer files and resets the installation metadata.
- Close the Visual Studio Installer.
- Delete the Visual Studio Installer directory. Typically, the directory is
C:\Program Files (x86)\Microsoft Visual Studio\Installer.
- Run the Visual Studio Installer bootstrapper. You might find the bootstrapper in your Downloads folder with a file name that follows a
vs_[Visual Studio edition]__*.exepattern. If you don't find that application, you can download the bootstrapper by going to the Visual Studio downloads page and clicking Download for your edition of Visual Studio. Then, run the executable to reset your installation metadata.
- Try to install or update Visual Studio again. If the Installer continues to fail, go to the next step.
Step 4 - Report a problem
In some situations, such as those related to corrupted files, the problems might have to be looked at on a case-by-case basis. To help us help you, please do the following:
- Collect your setup logs. See How to get the Visual Studio installation logs for details.
- Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool.
- Give your problem report a title, and provide relevant details. Click Next to go to the Attachments section, and then attach the generated log file (typically, the file is at
- Click Next to review your problem report, and then click Submit.
Step 5 - Run InstallCleanup.exe to remove installation files
As a last resort, you can remove Visual Studio to remove all installation files and product information.
- Follow the instructions in Remove Visual Studio.
- Rerun the bootstrapper that's described in Step 3 - Delete the Visual Studio Installer directory to fix upgrade problems.
- Try to install or update Visual Studio again.
Step 6 - Contact us (optional)
If none of the previous steps help you successfully install or upgrade Visual Studio, contact us by using our live chat support option (English only) for further assistance.
How to troubleshoot an offline installation
Here is a table of known issues and some workarounds that might help you when you install from a local layout.
|Users do not have access to files.||permissions (ACLs)||Make sure that you adjust the permissions (ACLs) so that they grant Read access to other users before you share the offline install.|
|New workloads, components, or languages fail to install.||
||Make sure that you have internet access if you install from a partial layout and select workloads, components, or languages that were not downloaded previously in that partial layout.|
How to get Visual Studio installation logs
Setup logs are needed to troubleshoot most installation issues. When you submit an issue by using Report a Problem in the Visual Studio Installer, these logs are automatically included in your report.
If you contact Microsoft Support, you might need to provide these setup logs by using the Microsoft Visual Studio and .NET Framework Log Collection Tool. The log collection tool collects setup logs from all components installed by Visual Studio 2017, including .NET Framework, Windows SDK, and SQL Server. It also collects computer information, a Windows Installer inventory, and Windows event log information for Visual Studio Installer, Windows Installer, and System Restore.
To collect the logs:
- Download the tool.
- Open an administrative command prompt.
Collect.exefrom the directory where you saved the tool.
- Find the resulting
vslogs.zipfile in your
%TEMP%directory, for example,
The tool must be run under the same user account that the failed installation was run under. If you are running the tool from a different user account, set the
–user:<name> option to specify the user account under which the failed installation was run. Run
Collect.exe -? from an administrator command prompt for additional options and usage information.
Get live help
If the solutions listed in this troubleshooting guide do not help you to successfully install or upgrade Visual Studio, use our live chat support option (English only) for further assistance.