Architecture
- The data plane runs entirely in your cloud account within a dedicated VPC, storing and processing your vectors, executing queries, and managing index data in object storage (S3 on AWS, GCS on GCP, or Azure Blob Storage on Azure). Cluster metadata lives in FoundationDB, which runs inside your Kubernetes cluster, so there’s no managed database to operate.
- The control plane is managed by Pinecone globally and handles index lifecycle management, authentication, billing, and user management, but never stores or processes your vectors.
Encryption and customer-managed keys
In the standard Pinecone service, customer-managed encryption keys (CMEK) are how you connect Pinecone-managed storage to your AWS KMS keys through the Pinecone console. In BYOC, that console CMEK flow doesn’t apply. Your vectors and index data are stored in your cloud account (for example, object storage and block storage), so you apply your cloud provider’s KMS to those resources using the same native controls you use for other workloads (key policies, rotation, and compliance programs such as PCI or ISO 27001). When you deploy with pulumi-pinecone-byoc, you can supply your KMS key where the template supports it. For the current options, see the pulumi-pinecone-byoc README.Limitations
Some features available in the standard Pinecone service aren’t yet supported or have constraints in BYOC:- Each organization can have up to 2 BYOC environments. To request an increase, contact Pinecone support.
- Integrated embedding and inference, which relies on models hosted by Pinecone outside your cloud account.
- Reading and writing data from the index browser in the Pinecone console.
- Pinecone CLI data plane operations (queries, upserts, fetches). Control plane operations (create, list, delete indexes) work as expected.
- Imports from private cloud storage buckets, unless the bucket is in the same cloud account as your BYOC deployment.
- On-demand indexes. BYOC supports dedicated read nodes indexes only.
Pricing
Your Pinecone bill for a BYOC environment has two parts: a flat platform fee and a rate for each dedicated read node you run. Separately, you pay your cloud provider directly for the underlying infrastructure (Kubernetes nodes, object storage, block storage, networking, etc.).
If an environment runs both
b1 and t1 nodes, calculate the node cost for each type and add the results.
Unlike dedicated read nodes in the standard service, BYOC has no separate Pinecone charges for storage or writes. That data lives in your own cloud account, so you pay your cloud provider for it instead of Pinecone.
Example: An environment with one index using two shards and two replicas runs four b1 nodes, so its monthly bill is the platform fee plus four times the b1 node rate, plus what you pay your cloud provider.
The Pinecone BYOC agent running in your cluster measures node usage, periodically reporting which nodes are provisioned. Billing follows the agent heartbeat connection to Pinecone’s control plane:
- When Pinecone receives heartbeats, you’re billed for the nodes the agent reports, even if the cluster is unhealthy.
- Short heartbeat interruptions (under 60 minutes) are treated as a grace period.
- If heartbeats are missing for more than 60 minutes, billing stops and the deployment is marked disconnected.
Pinecone bills for provisioned nodes, not query volume. You’re billed for nodes running in your cluster whether they’re idle, actively processing queries, or experiencing errors.
FAQs
Answers to common questions about BYOC:Does Pinecone have access to my cloud account?
Does Pinecone have access to my cloud account?
No. BYOC is designed so Pinecone never needs direct access to your infrastructure. Specifically:
- Pinecone does not need SSH, VPN, or inbound access to your cluster.
- You control cloud account boundaries, networking, and Kubernetes access.
- Operational changes run through explicit, software-mediated workflows.
- You don’t open inbound firewall ports for Pinecone operations.
What data leaves my cluster?
What data leaves my cluster?
Does not leave your cloud account:
- Vectors, metadata, and index contents
- Query and upsert payloads
- Customer data
- Operational metrics and traces (for example, CPU, memory, latency)
- Cluster health and operation status
What is the difference between BYOC and Pinecone's standard service?
What is the difference between BYOC and Pinecone's standard service?
In the standard service, Pinecone manages all cloud resources and includes their cost in the service fee. In BYOC, you provision and pay for cloud resources directly through your own cloud account, providing greater control, data sovereignty, and access to available cloud credits or discounts. For a cost breakdown, see Pricing.
How does authentication work?
How does authentication work?
You use API keys from the Pinecone console, just like with the standard Pinecone service. Authentication is handled by Pinecone’s global control plane, and your data plane caches API keys locally. This means you manage users and API keys through the console as usual.
How is data secured in BYOC?
How is data secured in BYOC?
Data is stored and processed exclusively within your cloud account, with encryption at rest and in transit. You control at-rest encryption for the underlying resources (including KMS keys in your account) the same way you do for other infrastructure. Communication between the data plane and control plane is encrypted using TLS. Private connectivity (AWS PrivateLink, GCP Private Service Connect, or Azure Private Link) can be used for additional network isolation. For how this relates to hosted CMEK, see Encryption and customer-managed keys.
Which cloud providers does BYOC support?
Which cloud providers does BYOC support?
BYOC is available on AWS, GCP, and Azure.
What happens if I destroy the cluster before deleting indexes?
What happens if I destroy the cluster before deleting indexes?
Indexes cannot be properly terminated if the cluster is destroyed first. Always delete indexes via the Pinecone API or console before running
pulumi destroy.What is the SLI project in my organization?
What is the SLI project in my organization?
Deploying a BYOC environment creates an internal project named
__SLI__ in your organization. This is used by Pinecone to enforce SLAs for your BYOC environment. Do not modify or delete this project.