|
1 | 1 | --- |
2 | | -title: Troubleshoot Visual Studio 2017, 2019, and 2020 Installation Failures |
| 2 | +title: Troubleshoot Visual Studio 2017 or Later Install Errors |
3 | 3 | description: Learn how to troubleshoot and resolve Visual Studio installation failures, including online and offline setup issues, with clear, actionable steps. |
4 | 4 | ms.date: 12/30/2025 |
5 | 5 | ms.reviewer: khgupta, v-shaywood |
6 | 6 | ms.custom: sap:Installation\Setup, maintenance, or uninstall |
7 | 7 | --- |
8 | 8 |
|
9 | | -# Unable to install Visual Studio 2017, 2019, or 2022 |
| 9 | +# Unable to install Visual Studio 2017 or later versions |
10 | 10 |
|
11 | | -_Applies to:_ Visual Studio 2017, 2019, and 2022 |
| 11 | +_Applies to:_ Visual Studio 2017 and later versions |
12 | 12 |
|
13 | | -When you try to install Visual Studio 2017, 2019, or 2022, you might encounter a problem where the installation wizard unexpectedly closes or returns an error message that indicates it couldn't download some installation files. This article provides a solution that resolves these installation problems and enables you to successfully install Visual Studio. |
| 13 | +When you try to install Visual Studio 2017 or a later version, you might encounter a problem where the installation wizard unexpectedly closes or returns an error message that indicates it couldn't download some installation files. This article provides a solution that resolves these installation problems and enables you to successfully install Visual Studio. |
14 | 14 |
|
15 | 15 | ## Symptoms |
16 | 16 |
|
17 | 17 | The symptoms of this problem depend on whether you're attempting an [online install](/visualstudio/install/install-visual-studio) or an [offline install](/visualstudio/install/create-an-offline-installation-of-visual-studio). |
18 | 18 |
|
19 | 19 | ### Online install |
20 | 20 |
|
21 | | -When you attempt an _online install_ of Visual Studio 2017, 2019, or 2022, the installation wizard shows the following message dialog: |
| 21 | +When you attempt an _online install_ of Visual Studio 2017 or a later version, the installation wizard shows the following message dialog: |
22 | 22 |
|
23 | 23 | > Before you get started, we need to set up a few things so that you can configure your installation. |
24 | 24 |
|
25 | | -:::image type="content" source="./media/install-failure-2017-2019-2022/install-wizard-set-up-things.png" alt-text="Screenshot of the Visual Studio installation wizard with a message that the installer needs to set up a few things so that you can configure your installation"::: |
| 25 | +:::image type="content" source="./media/install-failure-2017-later-versions/install-wizard-set-up-things.png" alt-text="Screenshot of the Visual Studio installation wizard with a message that the installer needs to set up a few things so that you can configure your installation"::: |
26 | 26 |
|
27 | 27 | After you select **Continue** in the message dialog, the installation wizard closes and the install stops. |
28 | 28 |
|
29 | 29 | ### Offline install |
30 | 30 |
|
31 | | -When you attempt an _offline install_ of Visual Studio 2017, 2019, or 2022 on a device with no or limited internet access, the installation wizard shows the following error dialog: |
| 31 | +When you attempt an _offline install_ of Visual Studio 2017 or a later version on a device with no or limited internet access, the installation wizard shows the following error dialog: |
32 | 32 |
|
33 | 33 | > Unable to download installation files. Check your internet connection and try again. |
34 | 34 |
|
35 | | -:::image type="content" source="./media/install-failure-2017-2019-2022/install-wizard-download-error.png" alt-text="Screenshot of the Visual Studio installation wizard with an error message that the installer was unable to download installation files"::: |
| 35 | +:::image type="content" source="./media/install-failure-2017-later-versions/install-wizard-download-error.png" alt-text="Screenshot of the Visual Studio installation wizard with an error message that the installer was unable to download installation files"::: |
36 | 36 |
|
37 | 37 | If your device has event logging enabled for the [CryptoAPI (CAPI2)](/windows/win32/seccrypto/cryptography--cryptoapi--and-capicom), you also see the following error in the CAPI2 [Event Viewer](/host-integration-server/core/windows-event-viewer1) logs (Event ID 30): |
38 | 38 |
|
39 | | -:::image type="content" source="./media/install-failure-2017-2019-2022/event-viewer-capi2-errors.png" alt-text="Screenshot of the Event Viewer showing multiple CAPI2 errors with Event ID 30"::: |
| 39 | +:::image type="content" source="./media/install-failure-2017-later-versions/event-viewer-capi2-errors.png" alt-text="Screenshot of the Event Viewer showing multiple CAPI2 errors with Event ID 30"::: |
40 | 40 |
|
41 | 41 | ```xml |
42 | 42 | <Event> |
@@ -68,12 +68,19 @@ Use the following steps to enable CAPI2 event logging: |
68 | 68 | 1. Right-click **Operational** and select **Clear Log** to delete any previous logs. |
69 | 69 | 1. Right-click **Operational** and select **Enable Log** to start logging. |
70 | 70 |
|
71 | | - :::image type="content" source="./media/install-failure-2017-2019-2022/event-viewer-enable-capi2-logs.png" alt-text="Screenshot of the Event Viewer with the right-click menu to clear or enable logs for CAPI2"::: |
| 71 | + :::image type="content" source="./media/install-failure-2017-later-versions/event-viewer-enable-capi2-logs.png" alt-text="Screenshot of the Event Viewer with the right-click menu to clear or enable logs for CAPI2"::: |
72 | 72 |
|
73 | 73 | 1. Try installing Visual Studio again by using the offline installer. |
74 | 74 | 1. After reproducing the issue, the CAPI2 event logs should contain details about the install failure. |
75 | 75 | 1. To stop logging, right-click **Operation** and select **Disable Log**. |
76 | 76 |
|
| 77 | +## Cause |
| 78 | + |
| 79 | +This problem can occur for one of the following reasons, depending on the type of installation: |
| 80 | + |
| 81 | +- _Offline install_: The device doesn't have the latest [Microsoft Windows Code Signing PCA 2024](https://www.microsoft.com/pkiops/certs/Microsoft%20Windows%20Code%20Signing%20PCA%202024.crt) certificate that Visual Studio uses. |
| 82 | +- _Online install_: The device's internet access is restricted and the user doesn't have permission to download the [Microsoft Windows Code Signing PCA 2024](https://www.microsoft.com/pkiops/certs/Microsoft%20Windows%20Code%20Signing%20PCA%202024.crt) certificate. |
| 83 | + |
77 | 84 | ## Solution |
78 | 85 |
|
79 | 86 | Use the following steps to resolve this problem: |
|
0 commit comments