From d42b6fa60a8bddbcd0833fbf8c14854442706b0e Mon Sep 17 00:00:00 2001 From: Steve Dower Date: Thu, 10 Sep 2026 22:21:15 +0100 Subject: [PATCH 1/2] Add documentation on PyManager proxy setting overrides (GH-156768) (cherry picked from commit 8f847875d60c81841e18a20510257a6e1b45b146) Co-authored-by: Steve Dower --- Doc/using/windows.rst | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 5bec0c57b12214..72d6bfe2354680 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -934,6 +934,37 @@ checking for that feed. } +Proxy Settings +-------------- + +.. versionadded:: 26.4 + +By default, the Python install manager will use your system-wide proxy settings, +including automatic authentication. For most users, this behaves the same as +your browser and other applications. + +To override the settings, use the ``NO_PROXY``, ``HTTP_PROXY`` and +``HTTPS_PROXY`` environment variables. These should be set in the terminal +session before using the Python install manager. Other applications may also +use the variables, so use caution before setting them globally for your entire +machine. + +Setting ``NO_PROXY`` to any non-empty value will disable the use of any proxy. +Use this to bypass your system's default proxy setting and attempt to access the +index server directly. + +Setting ``HTTPS_PROXY`` to a string like ``example.com:8080`` will connect to +that proxy server for all HTTPS connections. For the default index, all +connections will be using HTTPS, and so this is the usual setting to override. + +The ``HTTP_PROXY`` variable may be needed if you are using a private index +server that does not use encrypted connections, but does require the default +proxy server to be overridden. It follows the same format as ``HTTPS_PROXY``. + +Credentials may be embedded in either setting, however, when ``HTTPS_PROXY`` has +credentials embedded they will be used in preference to other credentials. Only +one set of credentials will be used for both types of proxy. + .. _pymanager-troubleshoot: Troubleshooting From 07d7625ab5990c1f37a7bd35d9bed8813895ff6b Mon Sep 17 00:00:00 2001 From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Date: Fri, 11 Sep 2026 20:59:49 +0300 Subject: [PATCH 2/2] Sentence case header --- Doc/using/windows.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 72d6bfe2354680..3423617c2870cc 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -934,7 +934,7 @@ checking for that feed. } -Proxy Settings +Proxy settings -------------- .. versionadded:: 26.4