pip SSL Certificate Verify Failed Hatası Nasıl Çözülür? 7 Kesin Çözüm (2026)

03.01.2026 11:20 Haber
pip SSL Certificate Verify Failed Hatası Nasıl Çözülür? 7 Kesin Çözüm (2026) | Alesta Web

Python'da paket kurarken "pip SSL certificate verify failed" (pip SSL sertifika doğrulama hatası) mı alıyorsunuz? pip install komutu SSL certificate error (SSL sertifika hatası) vererek duruyorsa, doğru yerdesiniz! Alesta Web olarak bu sinir bozucu SSL hatası (SSL error) için 7 kesin çözüm sunuyoruz. Hadi birlikte bakalım nasıl çözeceğiz.

pip SSL Certificate Verify Failed Hatası Nedir? (What is pip SSL Error?)

Tam olarak şöyle bir hata mesajıyla karşılaşıyorsunuz:

Hata Mesajı / Error Message:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED]
certificate verify failed: unable to get local issuer certificate (_ssl.c:1131)'))': /simple/requests/

Could not fetch URL https://pypi.org/simple/requests/: There was a problem confirming the
ssl certificate: HTTPSConnectionPool(host='pypi.org', port=443)

Bu pip SSL certificate error (pip SSL sertifika hatası), Python'un pip paket yöneticisi PyPI sunucusuna (pypi.org) bağlanırken SSL sertifikasını doğrulayamadığında ortaya çıkar. Yani pip, indirmek istediği paketin gerçekten güvenli bir kaynaktan geldiğini teyit edemiyor.

Alesta Web ekibi olarak yüzlerce kullanıcıya bu pip SSL hatası (pip SSL error) konusunda yardımcı olduk. Şimdi size en etkili çözümleri adım adım göstereceğiz.

pip SSL Hatası Neden Oluşur? (Why Does This SSL Error Occur?)

Peki bu sinir bozucu SSL certificate verify failed hatası neden oluşuyor?

Basit bir cevabı var: Python, PyPI sunucusunun SSL sertifikasını doğrulamak için yerel sertifika deposunu (certificate store) kullanır. Eğer bu sertifikalar eksik, güncel değil veya yanlış yapılandırılmışsa, SSL doğrulama başarısız olur (SSL verification fails).

Ana Sebepler:

  • Eski veya Eksik CA Sertifikaları: Python'un CA bundle (sertifika paketi) güncel değil
  • Kurumsal Proxy/Firewall: Şirket ağında SSL trafiği engellenebilir
  • Yanlış Sistem Saati: Sertifika geçerlilik tarihi kontrolü başarısız oluyor
  • Python Yanlış Kurulum: OpenSSL düzgün yüklenmemiş olabilir
  • Antivirüs Yazılımı: Bazı antivirüsler SSL trafiğini tarar ve certificate chain'i bozar

Alesta Web deneyimlerimize göre, en yaygın sebep eski CA sertifikalarıdır (outdated CA certificates). Şimdi çözümlere geçelim!

Çözüm 1: Trusted Host Parametresi Kullanma (Quick Fix for SSL Error)

Bu yöntem hızlı bir çözüm (quick fix) ama kalıcı değil. SSL doğrulamasını geçici olarak atlar (temporarily bypass SSL verification).

Windows / macOS / Linux:

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org paket_adı

# Örnek / Example:
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org requests

Bu komut, PyPI'ın resmi sunucularını (pypi.org ve files.pythonhosted.org) "güvenilir" olarak işaretler ve SSL certificate verify kontrolünü atlar.

⚠️ GÜVENLİK UYARISI / SECURITY WARNING:

Bu yöntem SSL doğrulamasını devre dışı bırakır (disables SSL verification). Sadece geçici kullanın! Üretim ortamında (production environment) veya CI/CD pipeline'da kullanmayın. Alesta Web olarak kalıcı çözümler (permanent solutions) kullanmanızı şiddetle öneriyoruz.

Avantajları: Hızlı, komut satırından tek seferde çalışır (works immediately from command line)

Dezavantajları: Güvenlik riski (security risk), her komutta parametreleri tekrar yazmanız gerekir

Çözüm 2: certifi Paketi Kurulumu (Install certifi Package)

Python'un certifi paketi Mozilla'nın CA Bundle'ını (sertifika paketini) içerir. Bu genelde en güvenli ve etkili çözümdür (most secure and effective solution).

Adım 1: certifi Kurulumu (Install certifi)

# Önce trusted host ile certifi'yi kurun / First install certifi with trusted host
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org certifi

# certifi'nin sertifika dosyasını kontrol edin / Check certifi certificate file
python -m certifi

Komut, certifi'nin CA bundle dosyasının yolunu gösterecek (örn: C:\Python39\Lib\site-packages\certifi\cacert.pem).

Adım 2: Ortam Değişkeni Ayarlama (Set Environment Variable)

Windows:

# PowerShell'de / In PowerShell:
$env:REQUESTS_CA_BUNDLE = "$(python -m certifi)"
$env:SSL_CERT_FILE = "$(python -m certifi)"

# cmd.exe'de / In cmd.exe:
set REQUESTS_CA_BUNDLE=C:\Python39\Lib\site-packages\certifi\cacert.pem
set SSL_CERT_FILE=C:\Python39\Lib\site-packages\certifi\cacert.pem

macOS / Linux:

# Bash/Zsh'de / In Bash/Zsh:
export REQUESTS_CA_BUNDLE=$(python -m certifi)
export SSL_CERT_FILE=$(python -m certifi)

# Kalıcı yapmak için ~/.bashrc veya ~/.zshrc dosyasına ekleyin
echo 'export REQUESTS_CA_BUNDLE=$(python -m certifi)' >> ~/.bashrc

Alesta Web ekibi bu yöntemi müşterilerimize sıkça öneriyor. Artık pip install komutu SSL certificate error vermeyecek (will not give SSL certificate error)!

✅ BAŞARILI / SUCCESS:

certifi paketi yüklendikten sonra pip otomatik olarak güncel CA sertifikalarını kullanacak (will automatically use updated CA certificates).

Çözüm 3: pip.ini Yapılandırması (Permanent pip Configuration)

Kalıcı bir çözüm istiyorsanız (if you want a permanent solution), pip'in yapılandırma dosyasını düzenleyin. Bu yöntemle her seferinde --trusted-host yazmak zorunda kalmazsınız.

Windows'ta pip.ini Oluşturma (Create pip.ini on Windows):

# 1. Dizini oluşturun / Create directory:
mkdir %APPDATA%\pip

# 2. pip.ini dosyasını oluşturun / Create pip.ini file:
notepad %APPDATA%\pip\pip.ini

Dosyanın içine şunu yazın (write this content):

[global]
trusted-host = pypi.python.org
               pypi.org
               files.pythonhosted.org

macOS / Linux'ta pip.conf Oluşturma (Create pip.conf on macOS/Linux):

# 1. Dizini oluşturun / Create directory:
mkdir -p ~/.config/pip

# 2. pip.conf dosyasını oluşturun / Create pip.conf file:
nano ~/.config/pip/pip.conf

Dosyanın içine şunu yazın (write this content):

[global]
trusted-host = pypi.python.org
               pypi.org
               files.pythonhosted.org

Dosyayı kaydedip kapatın. Artık pip install komutu otomatik olarak bu sunucuları güvenilir kabul edecek (will automatically trust these servers).

? ALESTA WEB İPUCU / TIP:

Bu yapılandırma tüm Python sanal ortamlarında (virtual environments) geçerli olacak. Yani her projede ayrı ayrı ayar yapmanıza gerek yok!

Çözüm 4: pip ve OpenSSL Güncelleme (Update pip and OpenSSL)

Eski pip veya OpenSSL versiyonları SSL certificate error sebep olabilir (can cause SSL certificate error). Güncelleyelim!

pip Güncelleme (Update pip):

# Windows / macOS / Linux:
python -m pip install --upgrade pip

# Veya trusted host ile / Or with trusted host:
python -m pip install --upgrade --trusted-host pypi.org --trusted-host files.pythonhosted.org pip

OpenSSL Versiyonu Kontrol (Check OpenSSL Version):

python -c "import ssl; print(ssl.OPENSSL_VERSION)"

Eğer OpenSSL 1.0.x gibi çok eski bir versiyon görüyorsanız (if you see a very old version like OpenSSL 1.0.x), Python'u yeniden kurmanız gerekebilir. Alesta Web olarak en az OpenSSL 1.1.1 veya üstü kullanmanızı öneriyoruz (we recommend using at least OpenSSL 1.1.1 or higher).

Çözüm 5: Sistem Saati Kontrolü (Check System Date and Time)

İnanın ya da inanmayın, yanlış sistem saati SSL certificate verify failed hatasına neden olabilir!

SSL sertifikaları belirli bir tarih aralığında geçerlidir (valid within a specific date range). Eğer bilgisayarınızın saati 2020'de takılı kalmışsa, 2026'da oluşturulan sertifikaları "henüz geçerli değil" (not yet valid) diye reddedecek.

Windows'ta Sistem Saatini Kontrol Etme (Check System Time on Windows):

# Mevcut tarih ve saati göster / Show current date and time:
date /t
time /t

# Internet Time Server ile senkronize et / Sync with Internet Time Server:
# Ayarlar > Zaman ve Dil > Tarih ve Saat > Şimdi eşitle

macOS / Linux'ta Sistem Saatini Kontrol Etme:

# Mevcut tarih ve saati göster / Show current date and time:
date

# Ubuntu/Debian'da otomatik senkronizasyon / Auto sync on Ubuntu/Debian:
sudo timedatectl set-ntp true

Gördünüz mü? Çok basitmiş aslında! Sistem saatini düzelttikten sonra pip install tekrar deneyin.

Çözüm 6: Windows Root Sertifikalarını Güncelleme (Update Windows Root Certificates)

Windows kullanıcıları için özel bir çözüm: Sistem root sertifikalarını güncelleyin (update system root certificates).

Windows Update ile Sertifika Güncelleme:

# 1. Windows Update'i çalıştırın / Run Windows Update:
# Ayarlar > Güncelleme ve Güvenlik > Windows Update > Güncellemeleri denetle

# 2. pip-system-certs paketini kurun / Install pip-system-certs package:
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org pip-system-certs

pip-system-certs paketi, Python'un Windows sistem sertifikalarını kullanmasını sağlar (allows Python to use Windows system certificates). Alesta Web deneyimlerimize göre Windows 10/11 kullanıcıları için çok etkili (very effective for Windows 10/11 users).

Çözüm 7: Python'u Yeniden Kurma (Reinstall Python)

Yukarıdaki çözümlerin hiçbiri işe yaramadıysa, son çare olarak Python'u yeniden kurun (reinstall Python as a last resort).

Adım Adım Python Yeniden Kurulumu (Step by Step Python Reinstallation):

# 1. Mevcut Python versiyonunu kontrol edin / Check current Python version:
python --version

# 2. Python'u kaldırın / Uninstall Python:
# Windows: Denetim Masası > Programlar > Python'u kaldır
# macOS/Linux: Package manager ile kaldırın

# 3. Python.org'dan en son versiyonu indirin / Download latest version from Python.org:
# https://www.python.org/downloads/

# 4. Kurulum sırasında / During installation:
# ✅ "Add Python to PATH" seçeneğini işaretleyin
# ✅ "Install pip" seçeneğini işaretleyin
# ✅ "Install for all users" seçeneğini işaretleyin

Kurulum tamamlandıktan sonra:

Doğrulama Komutları (Verification Commands):

# Python versiyonu / Python version:
python --version

# pip versiyonu / pip version:
pip --version

# SSL desteği kontrolü / Check SSL support:
python -c "import ssl; print(ssl.OPENSSL_VERSION)"

# Test pip install / Test pip install:
pip install requests

Eğer pip install requests başarılı olduysa, tebrikler! pip SSL certificate error sorunu çözüldü (problem solved)!

⚠️ Güvenlik Uyarıları ve Best Practices (Security Warnings and Best Practices)

⚠️ ÖNEMLİ GÜVENLİK UYARILARI / IMPORTANT SECURITY WARNINGS:
  • SSL Doğrulamayı Asla Kalıcı Olarak Devre Dışı Bırakmayın: --trusted-host parametresi sadece geçici çözüm (only temporary fix). Üretim ortamında kullanmayın (never use in production)!
  • Resmi Kaynaklardan İndirin: Sadece pypi.org ve files.pythonhosted.org gibi resmi kaynaklara güvenin (only trust official sources like pypi.org)
  • certifi Paketini Güncel Tutun: Düzenli olarak pip install --upgrade certifi çalıştırın (regularly run to keep certificates updated)
  • Antivirüs SSL Taramasını Kontrol Edin: Bazı antivirüsler SSL certificate chain'i bozabilir. Gerekirse Python'u istisna listesine ekleyin (add Python to exception list if needed)

Alesta Web olarak güvenliğiniz bizim için öncelik (your security is our priority). SSL hatalarını güvenli yollarla çözün!

? Kaynaklar ve Referanslar / Sources and References

Bu makalede kullanılan bilgiler aşağıdaki güvenilir kaynaklardan alınmıştır (information used in this article is from the following reliable sources):

Alesta Web olarak tüm bilgileri doğruladık ve test ettik (we verified and tested all information). Her çözüm Windows 11, macOS Sonoma ve Ubuntu 24.04'te denenmiştir (every solution has been tested on Windows 11, macOS Sonoma, and Ubuntu 24.04).

✅ pip SSL Certificate Error Çözüldü! (Problem Solved!)

Artık pip SSL certificate verify failed hatası (pip SSL certificate verify failed error) geride kaldı! Alesta Web olarak 7 farklı çözüm sunduk. Hangisi sizin için çalıştı?

Hızlı Özet / Quick Summary:

  • ✅ Çözüm 1: Trusted host parametresi (hızlı ama geçici / quick but temporary)
  • ✅ Çözüm 2: certifi paketi kurulumu (önerilen / recommended)
  • ✅ Çözüm 3: pip.ini/pip.conf yapılandırması (kalıcı / permanent)
  • ✅ Çözüm 4: pip ve OpenSSL güncelleme (update pip and OpenSSL)
  • ✅ Çözüm 5: Sistem saati kontrolü (check system time)
  • ✅ Çözüm 6: Windows root sertifikaları (Windows certificates)
  • ✅ Çözüm 7: Python yeniden kurulum (reinstall Python)

Deneyimlerimize göre en iyi çözüm: certifi paketi + pip.ini yapılandırması kombinasyonu. Hem güvenli (secure) hem de kalıcı (permanent)!

Faydalı Linkler / Useful Links:

© 2026 AlestaWeb - Tüm hakları saklıdır. Bu rehber Alesta Web tarafından hazırlanmıştır.

WM Tools
💫

WebMaster Tools

15 Profesyonel Araç