Troubleshoot Visual Studio installation and upgrade issues

Important

Having a problem installing? We can help. We offer an installation chat (English only) support option.

This troubleshooting guide includes step-by-step instructions that should resolve most installation issues.

Online installations

The following steps apply to a typical online installation. For an offline installation, see How to troubleshoot an offline installation.

Step 1 - Check whether the 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.

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.

There are some known issues with the Visual Studio Installer that Microsoft is working on fixing. Check if your problem is already solved, or find workarounds, in the Known Issues section of our release notes.

Step 2 - Try repairing Visual Studio

Repair fixes many common update issues. For more about when and how to repair Visual Studio, see Repair Visual Studio.

Step 3 - Check with the developer community

Search for your error message in the Visual Studio Developer Community channel. Other members of the community might have found a solution or workaround to your problem.

Step 4 - Delete the Visual Studio Installer folder to fix upgrade problems

The Visual Studio Installer bootstrapper is a light-weight executable that initiates the install of the Visual Studio Installer. Deleting the Visual Studio Installer files and then rerunning the bootstrapper solves some update failures.

Note

Performing the following actions reinstalls the Visual Studio Installer files and resets the installation metadata.

  1. Close the Visual Studio Installer.
  2. Delete the Visual Studio Installer installation directory. Typically, the directory is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. 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]__*.exe pattern. 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.
  4. Try to install or update Visual Studio again. If the Installer continues to fail, go to the next step.
  1. Close the Visual Studio Installer.
  2. Delete the Visual Studio Installer directory. Typically, the directory is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Run the Visual Studio Installer bootstrapper. You might find the bootstrapper in your Downloads folder with a file name that matches a vs_[Visual Studio edition]__*.exe pattern. 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.
  4. Try to install or update Visual Studio again. If the Installer continues to fail, go to the next step.
  1. Close the Visual Studio Installer.
  2. Delete the Visual Studio Installer folder. Typically, the folder path is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Run the Visual Studio Installer bootstrapper. You might find the bootstrapper in your Downloads folder with a file name that matches a vs_[Visual Studio edition]__*.exe pattern. Or, you can download the bootstrapper for your edition of Visual Studio from the Visual Studio downloads page. Then, run the executable to reset your installation metadata.
  4. Try to install or update Visual Studio again. If the Visual Studio Installer continues to fail, proceed to the Report a problem step.

Step 5 - Report a problem

In some situations, such as when there are corrupted files, issues might require case-by-case troubleshooting. To help us help you, follow these steps:

  1. Collect your setup logs. See How to get the Visual Studio installation logs for details.
  2. Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool. Screenshot showing the Provide feedback button in the Visual Studio Installer.
  3. 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 %TEMP%\vslogs.zip).
  4. Click Next to review the problem report, and then click Submit.
  1. Collect your setup logs. See How to get the Visual Studio installation logs for details.
  2. Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool. Screenshot showing the Provide feedback button in the Visual Studio Installer.
  3. 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 %TEMP%\vslogs.zip).
  4. Click Next to review your problem report, and then click Submit.
  1. Collect your setup logs. See How to get the Visual Studio installation logs for details.
  2. Open the Visual Studio Installer, and then choose Report a problem to open the Visual Studio Feedback tool. Screenshot showing the Provide feedback button in the Visual Studio Installer.
  3. Give your problem report a title, and provide the relevant details. The most recent setup log for the Visual Studio Installer is automatically added to the Additional attachments section of your problem report.
  4. Choose Submit.

Step 6 - Remove Visual Studio installation files

As a last resort, you can remove all Visual Studio installation files and product information:

  1. Follow the steps on the Remove Visual Studio page.
  2. Rerun the Visual Studio Installer bootstrapper. You might find the bootstrapper in your Downloads folder with a file name that matches a vs_[Visual Studio edition]__*.exe pattern. Or, you can download the bootstrapper for your edition of Visual Studio from the Visual Studio downloads page.
  3. Try to reinstall Visual Studio.

Step 7 - 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.

Offline installations

Here are some known issues and workarounds that might help you when you create an offline installation and install from a local layout.

Issue Solution
Users can't access files 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 language packs fail to install Make sure that you have internet access if you install from a partial layout and if you select workloads, components, or languages that weren't previously downloaded for that partial layout.

To resolve issues with a network installation, see Troubleshoot network-related errors when you install or use Visual Studio.

Installation logs

Setup logs help us troubleshoot most installation issues. When you submit an issue by using Report a Problem in the Visual Studio Installer, the most recent setup log for the Visual Studio Installer is automatically added to your report.

If you contact Microsoft Support, you might be asked to collect 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, including .NET Framework, Windows SDK, and SQL Server. It also collects computer information, a Windows Installer inventory, and Windows event log information for the Visual Studio Installer, Windows Installer, and System Restore.

To collect the logs:

  1. Download the tool.
  2. Open an administrative command prompt.
  3. Run Collect.exe in the folder where you saved the tool.
  4. The tool generates a vslogs.zip file in your %TEMP% folder, typically at C:\Users\YourName\AppData\Local\Temp\vslogs.zip.

Note

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.

Live help

If the solutions listed in this troubleshooting guide don't help you successfully install or upgrade Visual Studio, use our live chat support option (English only) for further assistance.

See also