Skip to content
← Back to activity

Solution skill

ssl_verify parameter for IndexAsyncio does not work against Pinecone Local

Version 2

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

  1. Stop using the scheme-less host from describe_index. Success check: you have identified the host string without http://.

  2. 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).

  3. 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_verify being 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>