Create a cluster
Weaviate Cloud (WCD) provides two cluster types.
- Free clusters: Free clusters are free forever and need no credit card, which makes them the easiest way to get started. They are perfect for learning, hobby projects, and small workloads, and you can upgrade to a paid plan at any time without losing your data. For the current free tier limits, see the pricing page.
- Shared Cloud clusters: Shared Cloud clusters are robust, paid clusters designed for production use.
When you log into the Weaviate Cloud web console, the Clusters panel lists your clusters. There are no clusters when you log in to a new account.
Free clusters
Section titled “Free clusters”Free clusters are the easiest way to start building with Weaviate. They are free forever, need no credit card, and are ideal for learning, hobby projects, and small workloads. Each user can create one free cluster, and you can upgrade to a paid plan at any time without losing your data.
The free tier includes a monthly allowance for the database, Weaviate Embeddings, and the Query Agent. For the current limits, see the pricing page.
Steps to create a free cluster
To create a free cluster, follow these steps:
- In the clusters sidebar, click the plus button.
- Select the
Freeoption. - Choose a name for your cluster.
- The optimization profile is set to
Cost Optimizedfor free clusters. - Select a cloud provider (GCP by default).
- Configure the
Advanced configurationsettings if needed (auto schema generation and CORS settings). - Click the
Create clusterbutton.
Advanced cluster configuration
The following advanced configuration settings are available:
Enable auto schema generationAllow all CORS origins
The MCP server is always enabled on Weaviate Cloud clusters. The Enable MCP Read-Only switch, which restricts it to its read tools, is off by default (so the write tool is available) and is not part of the free cluster creation form. Set it after creation from the cluster's Advanced configuration, no restart needed.
Shared Cloud clusters
Section titled “Shared Cloud clusters”Shared Cloud clusters require billing details. Weaviate Cloud prompts you to add billing details if you have not already added them.
Optimization profile
Section titled “Optimization profile”When you create a cluster, the Optimization profile sets the default vector index and compression for new collections in that cluster. Choose the profile that matches your workload:
- Cost Optimized: Uses the HFresh vector index for a lower memory footprint and reduced storage costs. Suitable for small or non-latency-sensitive workloads.
- Performance Optimized: Uses the HNSW vector index for efficient in-memory retrieval that balances speed and search quality. Suitable for most workloads.
The optimization profile only sets the default for new collections. You can still configure the vector index and compression for each collection when you create it.
Authentication
Section titled “Authentication”Weaviate Cloud clusters use API key authentication. The authentication approach depends on whether RBAC (Role-Based Access Control) is enabled:
Authentication with RBAC enabled
Section titled “Authentication with RBAC enabled”New clusters with Weaviate version v1.30 (or later) have RBAC enabled by default. With RBAC enabled, you create API keys with specific roles for granular access control.
When you develop your client application, use an API key to connect your client to the cluster. For detailed instructions on finding and managing your API keys, including creating new keys and managing roles, check out this guide:
Authentication with RBAC disabled (deprecated)
Section titled “Authentication with RBAC disabled (deprecated)”If RBAC is not enabled (before v1.30), clusters use the traditional approach with two default API keys:
- Admin keys: Provide read-write access to the database
- ReadOnly keys: Provide read-only access to the database
Shared Cloud clusters can create, delete, edit, and rotate API keys, while free clusters cannot modify the default keys.
Weaviate Database version
Section titled “Weaviate Database version”When you provision a new cluster, Weaviate Cloud uses the latest version of Weaviate to set up the new cluster. There may be a short delay between the release of a new Weaviate version and its availability in Weaviate Cloud.
Weaviate Cloud automatically updates existing clusters as new Weaviate versions become available.
For more details on Weaviate Cloud versioning, see:
Number of clusters
Section titled “Number of clusters”Each user can create one (1) free cluster. By default, an organization can have up to six (6) Shared Cloud clusters at the same time. To change these limits, contact support.
Support
Section titled “Support”If you use Weaviate Cloud (Database cluster(s) or Weaviate product in the cloud) or have a self-hosted support package, open a ticket in the Support Portal or email Weaviate support directly. To add a support plan, contact Weaviate sales.
Use the Support Portal for direct help from the Weaviate team: open and track tickets, and we'll respond in line with your support plan. The Community Forum is open to everyone, and a great place to ask questions, get help with your cluster, and connect with other developers. For all the ways to get help, see the Support overview.