Skip to content

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

Merged
muhsinking merged 2 commits intomainfrom
promptless/flash-ssl-cert-troubleshooting
Mar 23, 2026
Merged

docs: Add SSL certificate verification troubleshooting for Flash deploy#587
muhsinking merged 2 commits intomainfrom
promptless/flash-ssl-cert-troubleshooting

Conversation

@promptless
Copy link
Contributor

@promptless promptless bot commented Mar 23, 2026

Open this suggestion in Promptless to view citations and reasoning process

Adds a new troubleshooting entry for SSL certificate verification failures during flash deploy. Documents the actionable error message and provides solutions including certifi setup and the macOS-specific certificate installer.

Trigger Events

runpod/flash PR #279: fix: retry tarball upload on transient SSL and connection errors

Promptless Research (4 files, 1 GitHub PR)

  • Reviewed runpod/flash#279
  • Viewed .long_term_context/product_knowledge/product_overview.md
  • Viewed .long_term_context/doc_workflow/client_instructions.md
  • Viewed flash/troubleshooting.mdx
  • Viewed .long_term_context/style/client_style_guide.md

Agent Response

I've reviewed PR #279 and created a documentation update.

Summary

The PR adds retry logic for tarball uploads during flash deploy with:

  • Automatic retries (up to 3 times) with exponential backoff for transient SSL errors, connection resets, and timeouts
  • Special handling for SSL certificate verification failures that provides actionable guidance instead of retrying

Documentation Update

I created a new suggestion that adds a troubleshooting entry for SSL certificate verification errors. This documents:

  • The error message users will see
  • Why it occurs (Python can't find system CA certificates, common on fresh installs especially macOS)
  • Three solutions: installing certifi with the environment variable, running the macOS certificate installer, and persisting the fix in shell profile
  • A note explaining that transient SSL errors are automatically retried, but certificate verification issues require manual intervention

Suggestion: Add SSL certificate verification troubleshooting for Flash deploy

The retry mechanism itself doesn't need documentation since it's an implementation detail that improves reliability transparently. Users only need to know about errors that require action on their part.


Tip: Filter the Dashboard by labels or assignees to focus on what matters to you 🔎

flash build
```

### SSL certificate verification failed
Copy link
Contributor Author

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

@muhsinking muhsinking self-requested a review March 23, 2026 19:55
@promptless
Copy link
Contributor Author

promptless bot commented Mar 23, 2026

Just a reminder: If you'd like me to act on any feedback you have via Github comments, just type @Promptless in your suggestion and I'll get right on it! (I won't show up in the user dropdown, but I'll process any request that has @Promptless in the comment body.)

@muhsinking muhsinking merged commit 7d6a90c into main Mar 23, 2026
3 checks passed
@muhsinking muhsinking deleted the promptless/flash-ssl-cert-troubleshooting branch March 23, 2026 19:59
@mintlify
Copy link

mintlify bot commented Mar 23, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
runpod-docs 🔴 Failed Mar 23, 2026, 8:14 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant