Skip to content

docs: update quick start to Pingora 0.7 and fix missing openssl feature#812

Open
ByLCY wants to merge 1 commit intocloudflare:mainfrom
ByLCY:doc/quick_start
Open

docs: update quick start to Pingora 0.7 and fix missing openssl feature#812
ByLCY wants to merge 1 commit intocloudflare:mainfrom
ByLCY:doc/quick_start

Conversation

@ByLCY
Copy link

@ByLCY ByLCY commented Feb 10, 2026

Description

While following the docs/quick_start.md guide with Pingora 0.7, I encountered 502 Bad Gateway errors when the load balancer attempted to connect to HTTPS backends (1.1.1.1 / 1.0.0.1).

Investigation revealed that the openssl feature was missing, which is required for TLS connections.

This PR:

  • Updates the pingora version in the example Cargo.toml from 0.3 to 0.7 to match the latest release.
  • Adds the "openssl" feature to the pingora dependency to ensure HTTPS backends work correctly.

Motivation

Running the quick start example exactly as documented resulted in 502 errors due to missing TLS support. This change ensures new users have a working example out of the box.

- Update pingora dependency version from 0.3 to 0.7
- Add `openssl` feature to enable TLS for HTTPS backends
- Resolve 502 errors caused by missing TLS context
@drcaramelsyrup drcaramelsyrup added the documentation Improvements or additions to documentation label Feb 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants