# WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<pip._vendor.urllib3.connection.HTTPSConnection object at 0x...>: Failed to establish a new connection: [Errno 111] Connection refused')'

- **ID:** `python/pip-extra-index-unreachable`
- **Domain:** python
- **Category:** network_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

pip is configured with an extra index URL that is unreachable from the current network, causing retries before falling back.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |
| 3.12 | active | — | — |

## Workarounds

1. **** (90% success)
   ```
   pip config unset global.extra-index-url  # or edit ~/.config/pip/pip.conf
   ```
2. **** (85% success)
   ```
   pip install --index-url https://pypi.org/simple <package>
   ```

## Dead Ends

- **** — More retries just delay the same connection failure. (90% fail)
- **** — The connection is refused immediately; timeout is not the issue. (95% fail)
- **** — pip itself is fine; the configured index URL is the problem. (90% fail)