From ab14f36845275ec3f6aa691500feb3b8d72cfdcf Mon Sep 17 00:00:00 2001 From: Gordon Hogenson Date: Thu, 12 Mar 2026 14:05:32 -0700 Subject: [PATCH 1/6] Proxy config feature --- .../reference/proxy-firewall-troubleshoot.md | 92 ++++++++----------- docs/ide/reference/proxy-settings.md | 57 ++++++++++++ docs/ide/sign-in-access-multiple-accounts.md | 7 ++ ...tudio-behind-a-firewall-or-proxy-server.md | 2 + docs/toc.yml | 2 + 5 files changed, 108 insertions(+), 52 deletions(-) create mode 100644 docs/ide/reference/proxy-settings.md diff --git a/docs/ide/reference/proxy-firewall-troubleshoot.md b/docs/ide/reference/proxy-firewall-troubleshoot.md index 54a170a5b36..006a925a1c1 100644 --- a/docs/ide/reference/proxy-firewall-troubleshoot.md +++ b/docs/ide/reference/proxy-firewall-troubleshoot.md @@ -15,7 +15,19 @@ ai-usage: ai-assisted When you use Visual Studio behind a corporate proxy or firewall, you might encounter connectivity issues that affect features requiring network access, such as NuGet package restore, extension installation, and AI-powered features. Proxy issues generally fall into two categories: - **Configuration issues**: Problems with your proxy server setup, certificates, or network configuration. These issues are resolved by your IT administrator. -- **Settings required**: Visual Studio requires additional information about your network configuration. You can find more information about how to supply required settings to Visual Studio in this article. In the latest Insiders version of Visual Studio, you can configure the proxy within Visual Studio settings. You may enable the preview feature in **Tools** > **Options** > **All Settings** > **Preview Features** > **Proxy Configuration**. + +::: moniker range="visualstudio" + +- **Settings required**: Visual Studio requires additional information about your network configuration. You can configure proxy settings directly in the IDE. See [Configure proxy settings in Visual Studio](proxy-settings.md) for setup instructions. + +::: moniker-end + +::: moniker range="vs-2022" + +- **Settings required**: Visual Studio requires additional information about your network configuration. You can find more information about how to supply required settings to Visual Studio in this article. + +::: moniker-end + - **Product issues**: If you have determined that your issue is not a configuration issue or supplied settings do not address the issue you're seeing, then this could be a product issue. Follow the steps at [Collect diagnostic information](#product-issues-collect-diagnostic-information-for-support) before submitting a ticket. This article helps you identify which category your issue falls into and provides solutions for common problems. @@ -93,22 +105,19 @@ The following sections describe common proxy-related issues and their solutions. **Solution**: Visual Studio supports signing into GitHub and Microsoft Entra accounts behind an authenticating proxy with basic authentication, but most versions of Visual Studio don't have support for Copilot behind an authenticating proxy with basic authentication. -On startup, a prompt appears to capture credentials, and this is used for Entra authentication. The credentials persist in the Windows **Credential Manager** under **Windows Credentials** as `VSCredentials_` as the internet or network address, then the username and password that the proxy requires. - - ### Proxy authentication required (NTLM or Kerberos) **Symptom**: Network-dependent features don't work when using a proxy server with NTLM or Kerberos authentication. @@ -117,16 +126,17 @@ On startup, a prompt appears to capture credentials, and this is used for Entra **Solution**: Configure Visual Studio to use default proxy credentials: - -::: moniker range=">=vs-2022" +::: moniker range="vs-2022" Set the environment variable `VS_USE_DEFAULTPROXY` to `true`. For Copilot, also set `COPILOT_USE_DEFAULTPROXY` to `true`. @@ -143,56 +153,28 @@ Set the environment variable `VS_USE_DEFAULTPROXY` to `true`. For Copilot, also **Solution**: Configure the proxy server address explicitly: - -::: moniker range=">=vs-2022" +::: moniker range="vs-2022" Set the `HTTPS_PROXY` and `HTTP_PROXY` environment variables to your proxy server address. Copilot needs these set up for Visual Studio. ::: moniker-end - ## Troubleshoot SSL certificate issues @@ -277,5 +259,11 @@ Collect the following information: ## Related content +::: moniker range="visualstudio" + +- [Configure proxy settings in Visual Studio](proxy-settings.md) + +::: moniker-end + - [Install and use Visual Studio behind a firewall or proxy server](../../install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md) - [Visual Studio connectivity troubleshooting](../../install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md#troubleshoot-network-related-errors) diff --git a/docs/ide/reference/proxy-settings.md b/docs/ide/reference/proxy-settings.md new file mode 100644 index 00000000000..f91401ca0ef --- /dev/null +++ b/docs/ide/reference/proxy-settings.md @@ -0,0 +1,57 @@ +--- +title: Configure proxy settings in Visual Studio +description: Set a custom proxy server, port, and authentication for Visual Studio to connect through enterprise networks. +ms.date: 03/12/2026 +ms.topic: how-to +f1_keywords: +- VS.ToolsOptionsPages.Environment.ProxySettings +monikerRange: 'visualstudio' +author: ghogen +ms.author: ghogen +ms.subservice: general-ide +--- + +# Configure proxy settings in Visual Studio + +By default, Visual Studio uses your Windows proxy configuration. The IDE doesn't override system settings unless you choose to set a custom proxy. If your enterprise network requires a different proxy configuration for Visual Studio, you can set one directly in the IDE through the **Proxy Settings** options page. + +> [!NOTE] +> In this first release, the custom proxy settings apply to **GitHub Copilot experiences** and **sign-in flows for Entra ID and GitHub** within Visual Studio. A restart may be required for some features to pick up new proxy settings. + +## Prerequisites + +- Visual Studio installed. If you don't have it, see [Install Visual Studio](../../install/install-visual-studio.md). + +## Open the Proxy Settings page + +1. Select **Tools** > **Options** from the menu bar. +1. Select **Proxy Settings** to open the proxy configuration page. + + + +## Default behavior + +Out of the box, Visual Studio uses your Windows proxy configuration. You don't need to change any settings unless you require a proxy configuration that differs from your system default. + +## Set a custom proxy + +If you need a different proxy for Visual Studio: + +1. Open the **Proxy Settings** page (**Tools** > **Options** > **Proxy Settings**). +1. Select **Use custom proxy settings**. +1. Enter the **proxy server URL** and **port**. +1. Choose an authentication method: + - **Use the logged-in Windows account** — uses your current Windows credentials for integrated authentication (NTLM or Kerberos). + - **Use alternate credentials** — provide a **username** and **password** for the proxy. +1. Select **OK**. +1. Restart Visual Studio if prompted. + +> [!TIP] +> If your proxy requires Basic authentication, choose **Use alternate credentials** and enter the credentials your proxy expects. + +## Related content + +- [Troubleshoot proxy and firewall issues in Visual Studio](proxy-firewall-troubleshoot.md) +- [Install and use Visual Studio behind a firewall or proxy server](../../install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md) diff --git a/docs/ide/sign-in-access-multiple-accounts.md b/docs/ide/sign-in-access-multiple-accounts.md index 287716fe53e..add0ed290b2 100644 --- a/docs/ide/sign-in-access-multiple-accounts.md +++ b/docs/ide/sign-in-access-multiple-accounts.md @@ -48,3 +48,10 @@ Proxy credentials are stored in the Windows Credential Manager and are used as n > If the proxy server starts or changes after opening Visual Studio, the **Account Settings** dialog will show a warning, but you'll need to restart Visual Studio to get the proxy credentials prompt. ::: moniker-end + +::: moniker range="visualstudio" + +> [!TIP] +> You can also configure proxy settings directly in Visual Studio through **Tools** > **Options** > **Proxy Settings**. For more information, see [Configure proxy settings in Visual Studio](reference/proxy-settings.md). + +::: moniker-end diff --git a/docs/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md b/docs/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md index ded1ff58d46..d176131042d 100644 --- a/docs/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md +++ b/docs/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server.md @@ -154,6 +154,8 @@ Here are a few more support options: ## Related content +* [Configure proxy settings in Visual Studio](../ide/reference/proxy-settings.md) +* [Troubleshoot proxy and firewall issues in Visual Studio](../ide/reference/proxy-firewall-troubleshoot.md) * [Connectivity requirements for Live Share](/visualstudio/liveshare/reference/connectivity/) * [Create and maintain a network installation of Visual Studio](create-a-network-installation-of-visual-studio.md) * [Troubleshoot network-related errors in Visual Studio](/troubleshoot/developer/visualstudio/installation/troubleshoot-network-related-errors) diff --git a/docs/toc.yml b/docs/toc.yml index 38e4ea6397a..6f8fddb35a2 100644 --- a/docs/toc.yml +++ b/docs/toc.yml @@ -971,6 +971,8 @@ href: ide/visual-studio-performance-tips-and-tricks.md - name: Reference items: + - name: Configure proxy settings + href: ide/reference/proxy-settings.md - name: Troubleshoot proxy and firewall issues href: ide/reference/proxy-firewall-troubleshoot.md - name: Keyboard shortcuts & commands From 30a1e5535c8da615d8420be860c1637737ecb66b Mon Sep 17 00:00:00 2001 From: Gordon Hogenson Date: Wed, 18 Mar 2026 11:09:49 -0700 Subject: [PATCH 2/6] Incorporate feedback --- docs/ide/reference/proxy-firewall-troubleshoot.md | 7 +++++-- docs/ide/reference/proxy-settings.md | 10 +++++----- 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/docs/ide/reference/proxy-firewall-troubleshoot.md b/docs/ide/reference/proxy-firewall-troubleshoot.md index 006a925a1c1..566fbb2ac0f 100644 --- a/docs/ide/reference/proxy-firewall-troubleshoot.md +++ b/docs/ide/reference/proxy-firewall-troubleshoot.md @@ -20,6 +20,9 @@ When you use Visual Studio behind a corporate proxy or firewall, you might encou - **Settings required**: Visual Studio requires additional information about your network configuration. You can configure proxy settings directly in the IDE. See [Configure proxy settings in Visual Studio](proxy-settings.md) for setup instructions. + > [!NOTE] + > The proxy configuration experience is not yet available in all Visual Studio 2026 installations. If you don't see this in your installation, you can install [Visual Studio Insiders](https://visualstudio.microsoft.com/insiders/) to try it. Or, view the [Visual Studio 2022 version of this page](/visualstudio/ide/reference/proxy-firewall-troubleshoot?view=vs-2022) for guidance. + ::: moniker-end ::: moniker range="vs-2022" @@ -107,13 +110,13 @@ The following sections describe common proxy-related issues and their solutions. ::: moniker range="vs-2022" -On startup, a prompt appears to capture credentials, and this is used for Entra authentication. The credentials persist in the Windows **Credential Manager** under **Windows Credentials** as `VSCredentials_` as the internet or network address, then the username and password that the proxy requires. +On startup, a prompt appears to capture credentials. The credentials persist in the Windows **Credential Manager** under **Windows Credentials** as `VSCredentials_` as the internet or network address, then the username and password that the proxy requires. ::: moniker-end ::: moniker range="visualstudio" -On startup, a prompt appears to capture credentials, and this is used for Entra authentication. The credentials persist in the Windows **Credential Manager** under **Windows Credentials** as `VSCredentials_` as the internet or network address, then the username and password that the proxy requires. +On startup, a prompt appears to capture credentials. The credentials persist in the Windows **Credential Manager** under **Windows Credentials** as `VSCredentials_` as the internet or network address, then the username and password that the proxy requires. You can also configure proxy credentials directly in Visual Studio. See [Configure proxy settings in Visual Studio](proxy-settings.md). diff --git a/docs/ide/reference/proxy-settings.md b/docs/ide/reference/proxy-settings.md index f91401ca0ef..f703bf860f4 100644 --- a/docs/ide/reference/proxy-settings.md +++ b/docs/ide/reference/proxy-settings.md @@ -13,14 +13,14 @@ ms.subservice: general-ide # Configure proxy settings in Visual Studio -By default, Visual Studio uses your Windows proxy configuration. The IDE doesn't override system settings unless you choose to set a custom proxy. If your enterprise network requires a different proxy configuration for Visual Studio, you can set one directly in the IDE through the **Proxy Settings** options page. +By default, Visual Studio uses your Windows proxy configuration, but if your organization's network requires a different proxy configuration for Visual Studio, you can set one directly in the IDE through the **Proxy Settings** options page. > [!NOTE] > In this first release, the custom proxy settings apply to **GitHub Copilot experiences** and **sign-in flows for Entra ID and GitHub** within Visual Studio. A restart may be required for some features to pick up new proxy settings. ## Prerequisites -- Visual Studio installed. If you don't have it, see [Install Visual Studio](../../install/install-visual-studio.md). +The proxy configuration experience is not yet available in all Visual Studio 2026 installations. If you don't see this in your installation, you can install [Visual Studio Insiders](https://visualstudio.microsoft.com/insiders/) to try it. Or, view the [Visual Studio 2022 proxy troubleshooting page](/visualstudio/ide/reference/proxy-firewall-troubleshoot?view=vs-2022) for guidance. ## Open the Proxy Settings page @@ -33,11 +33,11 @@ By default, Visual Studio uses your Windows proxy configuration. The IDE doesn't ## Default behavior -Out of the box, Visual Studio uses your Windows proxy configuration. You don't need to change any settings unless you require a proxy configuration that differs from your system default. +By default, Visual Studio uses your Windows proxy configuration. You don't need to change any settings unless you require a proxy configuration that differs from the default for your user account. If the Windows settings are set to No Proxy, Visual Studio respects this and sets no proxy. -## Set a custom proxy +## Configure proxy settings -If you need a different proxy for Visual Studio: +To supply Visual Studio with proxy settings: 1. Open the **Proxy Settings** page (**Tools** > **Options** > **Proxy Settings**). 1. Select **Use custom proxy settings**. From 28a50e891117a94b63d423300ed0396d39996ef4 Mon Sep 17 00:00:00 2001 From: Gordon Hogenson Date: Fri, 20 Mar 2026 07:44:02 -0700 Subject: [PATCH 3/6] Fix validation issue --- docs/ide/reference/proxy-firewall-troubleshoot.md | 2 +- docs/ide/reference/proxy-settings.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ide/reference/proxy-firewall-troubleshoot.md b/docs/ide/reference/proxy-firewall-troubleshoot.md index 566fbb2ac0f..1c67e1903b5 100644 --- a/docs/ide/reference/proxy-firewall-troubleshoot.md +++ b/docs/ide/reference/proxy-firewall-troubleshoot.md @@ -21,7 +21,7 @@ When you use Visual Studio behind a corporate proxy or firewall, you might encou - **Settings required**: Visual Studio requires additional information about your network configuration. You can configure proxy settings directly in the IDE. See [Configure proxy settings in Visual Studio](proxy-settings.md) for setup instructions. > [!NOTE] - > The proxy configuration experience is not yet available in all Visual Studio 2026 installations. If you don't see this in your installation, you can install [Visual Studio Insiders](https://visualstudio.microsoft.com/insiders/) to try it. Or, view the [Visual Studio 2022 version of this page](/visualstudio/ide/reference/proxy-firewall-troubleshoot?view=vs-2022) for guidance. + > The proxy configuration experience is not yet available in all Visual Studio 2026 installations. If you don't see this in your installation, you can install [Visual Studio Insiders](https://visualstudio.microsoft.com/insiders/) to try it. Or, view the [Visual Studio 2022 version of this page](/visualstudio/ide/reference/proxy-firewall-troubleshoot?view=vs-2022&preserve-view=true) for guidance. ::: moniker-end diff --git a/docs/ide/reference/proxy-settings.md b/docs/ide/reference/proxy-settings.md index f703bf860f4..76e165c2f43 100644 --- a/docs/ide/reference/proxy-settings.md +++ b/docs/ide/reference/proxy-settings.md @@ -20,7 +20,7 @@ By default, Visual Studio uses your Windows proxy configuration, but if your org ## Prerequisites -The proxy configuration experience is not yet available in all Visual Studio 2026 installations. If you don't see this in your installation, you can install [Visual Studio Insiders](https://visualstudio.microsoft.com/insiders/) to try it. Or, view the [Visual Studio 2022 proxy troubleshooting page](/visualstudio/ide/reference/proxy-firewall-troubleshoot?view=vs-2022) for guidance. +The proxy configuration experience is not yet available in all Visual Studio 2026 installations. If you don't see this in your installation, you can install [Visual Studio Insiders](https://visualstudio.microsoft.com/insiders/) to try it. Or, view the [Visual Studio 2022 proxy troubleshooting page](/visualstudio/ide/reference/proxy-firewall-troubleshoot?view=vs-2022&preserve-view=true) for guidance. ## Open the Proxy Settings page From d613329e15a59ebd9e53c1f0e0b48e16866ea220 Mon Sep 17 00:00:00 2001 From: Gordon Hogenson Date: Fri, 20 Mar 2026 12:21:28 -0700 Subject: [PATCH 4/6] Incorp feedback --- docs/ide/reference/proxy-settings.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/ide/reference/proxy-settings.md b/docs/ide/reference/proxy-settings.md index 76e165c2f43..5f93827325d 100644 --- a/docs/ide/reference/proxy-settings.md +++ b/docs/ide/reference/proxy-settings.md @@ -22,10 +22,10 @@ By default, Visual Studio uses your Windows proxy configuration, but if your org The proxy configuration experience is not yet available in all Visual Studio 2026 installations. If you don't see this in your installation, you can install [Visual Studio Insiders](https://visualstudio.microsoft.com/insiders/) to try it. Or, view the [Visual Studio 2022 proxy troubleshooting page](/visualstudio/ide/reference/proxy-firewall-troubleshoot?view=vs-2022&preserve-view=true) for guidance. -## Open the Proxy Settings page +## Open the Proxy Configuration page 1. Select **Tools** > **Options** from the menu bar. -1. Select **Proxy Settings** to open the proxy configuration page. +1. Select **Proxy Configuration** to open the proxy configuration page.