From ceae69085b41fd81d5842b045f81c16961226968 Mon Sep 17 00:00:00 2001 From: Harshit Sharma <66710144+harshitethic@users.noreply.github.com> Date: Sun, 30 Aug 2026 17:18:05 +0530 Subject: [PATCH 1/2] docs: clarify pip index configuration during PyPI migration --- source/guides/migrating-to-pypi-org.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/source/guides/migrating-to-pypi-org.rst b/source/guides/migrating-to-pypi-org.rst index 2b565e8ee..40c0041fe 100644 --- a/source/guides/migrating-to-pypi-org.rst +++ b/source/guides/migrating-to-pypi-org.rst @@ -135,6 +135,21 @@ Downloading packages ``pypi.org`` is the default host for downloading packages. +If you have configured pip to use a custom ``index-url``, that setting can +override the default PyPI index. Check your pip configuration files if pip +continues to use the old PyPI URL after migration. The command ``pip config +list -v`` can be used to show the configuration files pip is loading. + +For example, a configuration containing:: + + [global] + index-url = https://pypi.python.org/pypi + +should be updated to use the current PyPI URL:: + + [global] + index-url = https://pypi.org/simple + Managing published packages and releases ---------------------------------------- From 2bd18c4c1b19abf7d1fc604daafe6b085f15caa5 Mon Sep 17 00:00:00 2001 From: Harshit Sharma <66710144+harshitethic@users.noreply.github.com> Date: Thu, 3 Sep 2026 21:51:21 +0530 Subject: [PATCH 2/2] docs: generalize legacy index migration guidance --- source/guides/migrating-to-pypi-org.rst | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/source/guides/migrating-to-pypi-org.rst b/source/guides/migrating-to-pypi-org.rst index 40c0041fe..1f16d4365 100644 --- a/source/guides/migrating-to-pypi-org.rst +++ b/source/guides/migrating-to-pypi-org.rst @@ -135,20 +135,15 @@ Downloading packages ``pypi.org`` is the default host for downloading packages. -If you have configured pip to use a custom ``index-url``, that setting can -override the default PyPI index. Check your pip configuration files if pip -continues to use the old PyPI URL after migration. The command ``pip config -list -v`` can be used to show the configuration files pip is loading. - -For example, a configuration containing:: - - [global] - index-url = https://pypi.python.org/pypi - -should be updated to use the current PyPI URL:: - - [global] - index-url = https://pypi.org/simple +If downloads still use the old ``pypi.python.org`` host, check whether your +installer is configured to override its default package index. Configuration +files, environment variables, and command-line options can all change the +index used by an installer. Remove or update any override that points at the +old host, using that installer's documentation to locate its active +configuration. + +For pip, see its :ref:`configuration documentation ` for the +supported configuration files, environment variables, and commands. Managing published packages and releases ----------------------------------------