Skip to content

docs: improve SSL certificate troubleshooting guidance#11354

Open
fahe1em1 wants to merge 1 commit intocontinuedev:mainfrom
fahe1em1:codex/continue-9175-ssl-docs
Open

docs: improve SSL certificate troubleshooting guidance#11354
fahe1em1 wants to merge 1 commit intocontinuedev:mainfrom
fahe1em1:codex/continue-9175-ssl-docs

Conversation

@fahe1em1
Copy link

@fahe1em1 fahe1em1 commented Mar 12, 2026

Summary

This improves the SSL/TLS troubleshooting path by making the common certificate errors searchable and actionable. It adds exact error strings to the FAQ, a dedicated troubleshooting section with curl and openssl diagnosis steps plus a caBundlePath example, and a cross-link from the self-hosting guide. It also softens the Windows guidance so win-ca is not presented as the only fix and points readers back to caBundlePath as the reliable option.

Testing

  • npx --yes prettier --check docs/faqs.mdx docs/troubleshooting.mdx docs/guides/how-to-self-host-a-model.mdx
  • npx mintlify broken-links

Why this is small and safe

This is a docs-only change scoped to three existing pages. It does not change runtime behavior or config parsing, but it should make a recurring support issue much easier to diagnose and fix.

Fixes #9175


Summary by cubic

Improves SSL/TLS troubleshooting docs with exact error strings, step-by-step curl/openssl diagnosis, and a clear requestOptions.caBundlePath example, plus a cross-link from self-hosting. Updates Windows guidance to note win-ca as optional and point to caBundlePath as the reliable fix. Fixes #9175.

Written for commit 0c3792e. Summary will update on new commits.

@fahe1em1 fahe1em1 requested a review from a team as a code owner March 12, 2026 19:30
@fahe1em1 fahe1em1 requested review from sestinj and removed request for a team March 12, 2026 19:30
@dosubot dosubot bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Mar 12, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Mar 12, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@fahe1em1
Copy link
Author

I have read the CLA Document and I hereby sign the CLA

Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

No issues found across 3 files

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

Labels

size:M This PR changes 30-99 lines, ignoring generated files.

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

Improve SSL certificate error documentation and troubleshooting

1 participant