pip install fails with SSL error
This error matches known, documented patterns with reliable solutions.
Quick Fix (Most Common Solution)
- Update certifi package
- Use --trusted-host pypi.org
Seeing "pip install fails with SSL error"? This error can be frustrating, but it's usually fixable. It typically affects your development workflow or system. Below you'll find clear, step-by-step solutions to resolve this issue.
What This Error Means
pip cannot verify the SSL certificate of PyPI.
Frequently documented in developer and vendor support forums.
Not affiliated with browser, OS, or device manufacturers.
New here? Learn why exact error messages matter →
Common Causes
- Outdated certificates
- Corporate proxy
- Network security software
How to Fix
- Update certifi package
- Use --trusted-host pypi.org
- Update pip to latest version
Last reviewed: April 2026 How we review solutions
OS-Specific Behavior
PIP SSL ERROR on Windows: Path, Shell, and Script Differences
PIP SSL ERROR on Windows because of path separator differences, case sensitivity, shell availability, and how Windows handles scripts.
The most impactful differences: Windows uses backslash (\) as the path separator — use pathlib.Path or os.path.join() rather than string concatenation. Windows is case-insensitive for paths, so import MyModule and import mymodule both work on Windows but only one works on Linux. os.system() or subprocess commands that call bash, grep, sed, or awk fail on Windows unless run inside WSL2 or Git Bash. Python scripts without a shebang line need python script.py explicitly — not ./script.py. For PowerShell users, the activation script for venv is .venv\Scripts\Activate.ps1, but PowerShell's execution policy may block it — run Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser once to allow signed local scripts.Need reliable hosting?
DigitalOcean offers simple cloud infrastructure with $200 free credit for new users.
Try DigitalOcean →We may earn a commission from tools recommended in our fixes.
Optional follow-up
Some users ask whether saving fixes for recurring errors would be useful when the same issue appears again.
Was this explanation helpful?
Frequently Asked Questions
Is trusted-host safe?
It bypasses SSL verification - use only when necessary.
How do I update certificates?
Run pip install --upgrade certifi
Related Resources
Also Known As
- Python exception
- Python traceback
- Python runtime error
- Python crash
Common Search Variations
- "python error fix"
- "python script not working"
- "python traceback what does it mean"
- "how to fix python exception"
- "python crash on startup"
- "python import error solution"
Related Errors
Still Stuck?
Paste a different error message or upload a screenshot to get help instantly.