Skip to content

docs: Add SSL certificate verification troubleshooting for Flash deploy #587

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
muhsinking merged 2 commits into from
Mar 23, 2026
Merged

docs: Add SSL certificate verification troubleshooting for Flash deploy #587

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7d23a79
Add SSL certificate verification troubleshooting for Flash deploy
promptless[bot] Mar 23, 2026
61a5239
Merge branch 'main' into promptless/flash-ssl-cert-troubleshooting
muhsinking Mar 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions flash/troubleshooting.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -246,6 +246,35 @@ rm -rf .flash
flash build
```

### SSL certificate verification failed
Copy link
Contributor Author

@promptless promptless bot Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Citation: Based on the new _upload_tarball() helper in src/runpod_flash/core/resources/app.py which detects SSL certificate verification failures and raises an SSLError with actionable guidance about CA certificates, certifi, and the macOS certificate installer.
View source


**Error:**
```
SSL certificate verification failed. This usually means Python cannot find your system's CA certificates.
```

**Cause:** Python cannot locate the system's trusted CA certificates, preventing secure connections during deployment. This commonly occurs on fresh Python installations, especially on macOS.

**Solution:** Try one of these fixes:

1. **Install certifi and set the certificate bundle path:**
```bash
pip install certifi
export REQUESTS_CA_BUNDLE=$(python -c "import certifi; print(certifi.where())")
```

2. **macOS only:** Run the certificate installer that comes with Python. Find it in your Python installation folder (typically `/Applications/Python 3.x/`) and run `Install Certificates.command`.

3. **Add to shell profile for persistence:**
```bash
echo 'export REQUESTS_CA_BUNDLE=$(python -c "import certifi; print(certifi.where())")' >> ~/.bashrc
source ~/.bashrc
```

<Note>
Transient SSL errors (like connection resets) are automatically retried during upload. The certificate verification error requires manual intervention because it indicates a system configuration issue.
</Note>

### Resource provisioning failed

**Error:**
Expand Down
Loading