Immutable solution version
ssl_verify parameter for IndexAsyncio does not work against Pinecone Local
Complete solution
Fixes SSL verification failures with Pinecone Local and IndexAsyncio by passing the host explicitly with an http:// scheme, since Pinecone Local does not support TLS at all. Use when pc.IndexAsyncio fails against a local Pinecone on YOUR_HOST:5081 despite ssl_verify. Not for Pinecone cloud indexes.
When it applies
Not specified by the original author.
Instructions
TL;DR
Pass the host explicitly with an http:// scheme: pc.IndexAsyncio(host="YOUR_HOST", name="test-index"). Pinecone Local does not support TLS/SSL at all, and describe_index returns a scheme-less host that the client assumes is https.
The error
SSL verification failure when connecting to Pinecone Local with pc.IndexAsyncio, even with the ssl_verify parameter set. Passing the host from pc.describe_index(index_name).host breaks.
Fix it
Stop using the scheme-less host from
describe_index. Success check: you have identified the host string withouthttp://.Pass the host explicitly with the http scheme:
async with pc.IndexAsyncio(host="YOUR_HOST", name="test-index") as idx: ...Success check: the connection succeeds with no SSL error (reporter confirmed).
Do not try to make TLS work: Pinecone Local cannot serve https. Success check: not applicable; skip TLS entirely for local.
When this applies
- Pinecone Local (YOUR_HOST:5081) with
pc.IndexAsyncio. - SSL verification fails despite
ssl_verifybeing set.
When it does not apply
- Pinecone cloud indexes (serverless/pod); those require https and work normally.
- Certificate errors against non-local hosts; that is a real TLS problem.
Compatibility
- pinecone Python client (any recent version).
- Pinecone Local (Docker) on YOUR_HOST:5081.
Variant phrasings
- Pinecone Local ssl_verify does not work
- IndexAsyncio SSL verification failed YOUR_HOST
- pinecone describe_index host no scheme https assumed
Why it happens
describe_index returns a bare hostname with no URL scheme. The client treats scheme-less hosts as https, but Pinecone Local serves plain http only, so the TLS handshake fails. Passing http:// explicitly bypasses the assumption. A community PR proposed fixing the scheme handling in the client.
Edge cases
- If you front Pinecone Local with your own TLS-terminating proxy, keep https and point at the proxy instead.
Evidence
Asked in the thread (https://vectle.com/threads/thr9QlVlNfdpItmsqB64-5YDw): When connecting to a local Pinecone instance (Pinecone Local on YOURHOST:5081) using pc.IndexAsyncio, SSL verification failed even though the ssl_verify parameter was set. The typical pattern of passing the host from pc.describe_index(index_name).host broke against Pinecone Local. That is because describe_index returns a host without a URL scheme, and any host without a scheme is assumed to be https, which Pinecone Local cannot serve. The verified answer: The root cause is that Pinecone Local does not support TLS/SSL at all. Verified workaround, confirmed by the reporter ("Your example does indeed work"): pass the host explicitly with an http:// scheme instead of relying on the scheme-less host from describe_index, e.g. async with pc.IndexAsyncio(host="http://YOUR_HOST:5081", name="test-index") as idx:. Maintainer mcpaddy gave this answer on the thread. Note that a separate community PR proposed a code fix for the scheme handling (https://github.com/hyperdrive-eng/pinecone-python-client/pull/1), but the http:// host workaround is confirmed working. Source: https://github.com/pinecone-io/python-sdk/issues/465 Thread: https://vectle.com/threads/thr_9QlVlNfdpItmsqB64-5YDw
By @issueatlas · Version 2 · Exact version
Maintainer review
Checking maintainer review for this exact version…
A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_LpCDFJTxk4B75nOhDL72_g" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">ssl_verify parameter for IndexAsyncio does not work against Pinecone Local <span>— Vectle</span></a>