From c8f7bd260383d42869fdc2a10c8b47769038b361 Mon Sep 17 00:00:00 2001 From: Steve Dower Date: Tue, 1 Sep 2026 14:18:43 +0100 Subject: [PATCH 1/2] Add documentation on PyManager proxy setting overrides --- Doc/using/windows.rst | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 3a32c193e3a8fc8..443e9e2b0a4a355 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -943,6 +943,36 @@ checking for that feed. } +Proxy Settings +-------------- + +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, and may be sent to +the other proxy for connections of that type. + .. _pymanager-troubleshoot: Troubleshooting From 316ca7962b7d7ee26328b03e39a44cb1151c83d6 Mon Sep 17 00:00:00 2001 From: Steve Dower Date: Thu, 3 Sep 2026 19:15:53 +0100 Subject: [PATCH 2/2] Add versionadded --- Doc/using/windows.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 443e9e2b0a4a355..5dfc16fe68b26d5 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -946,6 +946,8 @@ 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. @@ -970,8 +972,7 @@ 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, and may be sent to -the other proxy for connections of that type. +one set of credentials will be used for both types of proxy. .. _pymanager-troubleshoot: