Troubleshoot Visual Studio installation and upgrade issues

  • Article
  • 6 minutes to read

Important

Having a problem installing? We can assist. Nosotros offer an installation conversation (English only) support option.

This troubleshooting guide includes footstep-by-footstep instructions that should resolve most installation problems.

Online installations

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

Step 1 - Bank check whether the problem is a known event

There are some known problems with the Visual Studio Installer that Microsoft is working on fixing. Check if your trouble is already solved, or detect workarounds, in the Known Issues department of our release notes.

Step ii - Effort repairing Visual Studio

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

Step 3 - Check with the programmer community

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

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

The Visual Studio bootstrapper is a light-weight executable that initiates the install of the Visual Studio Installer and so the Visual Studio product. Deleting the Visual Studio Installer files and so 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 bootstrapper. Yous might find the bootstrapper in your Downloads folder with a file name that follows a vs_[Visual Studio edition]__*.exe design. If you lot don't discover that awarding, you tin can download the bootstrapper by going to the Visual Studio older downloads page and clicking Download for your edition of Visual Studio. So, run the executable to reset your installation metadata.
  4. Try to install or update Visual Studio again. If the Installer continues to fail, go along to the Report a trouble stride.
  1. Close the Visual Studio Installer.
  2. Delete the Visual Studio Installer folder. Typically, the folder path is C:\Programme 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 blueprint. Or, you tin download the bootstrapper for your edition of Visual Studio from the Visual Studio downloads page. And then, run the executable to reset your installation metadata.
  4. Endeavour to install or update Visual Studio again. If the Visual Studio Installer continues to fail, go on to the Study a problem pace.

Step v - Report a problem

In some situations, such as when there are corrupted files, issues might require case-past-instance troubleshooting. To help u.s. aid you, follow these steps:

  1. Collect your setup logs. See How to go the Visual Studio installation logs for details.
  2. Open the Visual Studio Installer, and 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 Side by side 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, then click Submit.
  1. Collect your setup logs. See How to get the Visual Studio installation logs for details.
  2. Open up the Visual Studio Installer, and so click Report a problem to open the Visual Studio Feedback tool. Screenshot showing the Provide feedback button in the Visual Studio Installer.
  3. Requite your problem report a title, and provide relevant details. Click Next to go to the Attachments section, and so attach the generated log file (typically, the file is at %TEMP%\vslogs.aught).
  4. Click Adjacent 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 up the Visual Studio Installer, and and then choose Report a problem to open up the Visual Studio Feedback tool. Screenshot showing the Provide feedback button in the Visual Studio Installer.
  3. Requite your problem study a title, and provide the relevant details. The most contempo setup log for the Visual Studio Installer is automatically added to the Additional attachments section of your problem report.
  4. Choose Submit.

Pace 6 - Remove Visual Studio installation files

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

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

Footstep 7 - Contact united states of america (optional)

If none of the previous steps help you successfully install or upgrade Visual Studio, contact us by using our alive chat support choice (English language only) for further assistance.

Offline installations

Hither are some known problems and workarounds that might aid you lot when you create an offline installation and install from a local layout.

Result Solution
Users tin't access files Make sure that you conform the permissions (ACLs) so that they grant read admission 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 fractional layout.

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

Ambassador Updates

Administrator updates may not be applied correctly due to a vareity of situations. Refer to the Administrator updates troubleshooting error codes for further information.

Installation logs

Setup logs help united states troubleshoot about 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 lot contact Microsoft Back up, you might be asked to collect setup logs by using the Microsoft Visual Studio and .NET Framework log drove tool. The log collection tool collects setup logs from all components installed past Visual Studio, including .Internet Framework, Windows SDK, and SQL Server. It besides collects computer data, 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.zippo.

Note

The tool must be run nether the same user business relationship that the failed installation was run nether. If yous are running the tool from a different user account, set the –user:<proper name> pick to specify the user account nether which the failed installation was run. Run Collect.exe -? from an administrator command prompt for additional options and usage information.

Issues installing WebView2

WebView2 is a component that is required by Visual Studio, just installation of this component can be blocked by your organization's Group Policies. Blocking the installation of WebView2 will prevent Visual Studio from existence installed.

2 policies command the ability to install WebView2: Microsoft Edge 'Install (WebView)' and Microsoft Edge 'InstallDefault'.

• If the Microsoft Edge 'Install (WebView)' policy is configured, it volition decide whether WebView2 can be installed. • If the Microsoft Edge 'Install (WebView)' policy is non configured, the Microsoft Edge 'InstallDefault' policy will determine whether WebView2 tin exist installed.

Note

If neither policy is configured, WebView2 installation is immune past your organisation.

Alive assistance

If the solutions listed in this troubleshooting guide don't help you successfully install or upgrade Visual Studio, utilise our alive chat support selection (English simply) for further assistance.

See also

  • Repair Visual Studio
  • Remove Visual Studio
  • Install and use Visual Studio and Azure Services behind a firewall or proxy server
  • Tools for detecting and managing Visual Studio instances
  • Visual Studio administrator guide