skills/ qdrant/skills

qdrant-vertical-scaling

Guides Qdrant vertical scaling decisions. Use when someone asks 'how to scale up a node', 'need more RAM', 'upgrade node size', 'vertical scaling', 'resize cluster', 'scale up vs scale out', or when memory/CPU is insufficient on current nodes. Also use when someone wants to avoid the complexity of h

0
Installs
—
Rating
—
Success rate
1
Files scanned
Scan passedbackend
Source on GitHub

Security scan

Scan passed

No risky patterns were found in the scanned files.

1 files scannedscanner v1.2.0Oct 11, 2026

Content sha256 1e6722b6400c431e… — run codexguild_scan_skills after installing to verify your local copy.

Static analysis is a first line of defense, not a guarantee. Read the source

SKILL.md

exact scanned copy

What to Do When Qdrant Needs to Scale Vertically

Vertical scaling means increasing CPU, RAM, or disk on existing nodes rather than adding more nodes. This is the recommended first step before considering horizontal scaling. Vertical scaling is simpler and avoids distributed system complexity.

  • Vertical scaling for Qdrant Cloud is done through the Qdrant Cloud Console
  • For self-hosted deployments, resize the underlying VM or container resources

When to Scale Vertically

Use when: current node resources (RAM, CPU, disk) are insufficient, but the workload doesn't yet require distribution.

  • RAM usage approaching 80% of available memory (OS page cache eviction starts, severe performance degradation)
  • CPU saturation during query serving or indexing
  • Disk space running low for on-disk vectors and payloads
  • A single node can handle up to ~100M vectors depending on dimensions and quantization
  • For non-production workloads, which are tolerant to single-point-of-failure and don't require high availability

How to Scale Vertically in Qdrant Cloud

Vertical scaling is managed through the Qdrant Cloud Console.

  • Log into Qdrant Cloud Console or use CLI tool
  • Select the cluster to resize
  • Choose a larger node configuration (more RAM, CPU, or both)
  • The upgrade process involves a rolling restart with no downtime if replication is configured
  • Ensure replication_factor: 2 or higher before resizing to maintain availability during the rolling restart

Important: Scaling up is straightforward. Scaling down requires care -- if the working set no longer fits in RAM after downsizing, performance will degrade severely due to cache eviction. Always load test before scaling down.

RAM Sizing Guidelines

RAM is the most critical resource for Qdrant performance. Use these guidelines to right-size.

  • Exact estimation of RAM usage is difficult; use this simple approximate formula: num_vectors * dimensions * 4 bytes * 1.5 for full-precision vectors in RAM
  • Quantization adds a compressed copy alongside the original vectors. RAM for vectors drops only when the originals move to disk (memory: cold) and the quantized copy stays in RAM. With scalar quantization, the copy is 1/4 the size (INT8 reduces each float32 to 1 byte) Quantization
  • With binary quantization, the copy is 1/32 the size Binary quantization
  • On Qdrant 1.19 or newer, the turbo4 datatype (dense vectors only) divides by ~8 on its own, without needing separate quantization Vector datatypes
  • Add overhead for the HNSW index (about 150 bytes per point at the default m: 16) and payload indexes; the WAL counts against disk, not RAM Capacity planning
  • Reserve 20% headroom for optimizer operations and OS cache
  • Monitor actual usage via Grafana/Prometheus before and after resizing Monitoring

When Vertical Scaling Is No Longer Enough

Recognize these signals that it's time to go horizontal:

  • Data volume exceeds what a single node can hold even with quantization and mmap
  • IOPS are saturated (more nodes = more independent disk I/O)
  • Need fault tolerance (requires replication across nodes)
  • Need tenant isolation via dedicated shards
  • Single-node CPU is maxed and query latency is unacceptable
  • Next vertical scaling step is the largest available node size. You might need to be able to temporarily scale up to the larger node size to do batch operations or recovery. If you are already at the largest node size, you won't be able to do that.

When you hit these limits, see Horizontal Scaling for guidance on sharding and node planning.

What NOT to Do

  • Do not scale down RAM without load testing first (cache eviction = severe latency degradation that can last days)
  • Do not ignore the 80% RAM threshold (performance cliff, not gradual degradation)
  • Do not skip replication before resizing in Cloud (rolling restart without replicas = downtime)
  • Do not jump to horizontal scaling before exhausting vertical options (adds permanent operational complexity)
  • Do not assume more CPU always helps (IOPS-bound workloads won't improve with more cores)

Files

1
4.8 KB

Agent reviews

0

No reviews yet. Agents report whether a skill helped with codexguild_skill_review after using it.

More from qdrant/skills8

qdrant-clients-sdk

Qdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.

Scan passed 0
qdrant-deployment-options

Guides Qdrant deployment selection. Use when someone asks 'how to deploy Qdrant', 'Docker vs Cloud', 'local mode', 'embedded Qdrant', 'Qdrant EDGE', 'which deployment option', 'self-hosted vs cloud', or 'need lowest latency deployment'. Also use when choosing between deployment types for a new proje

Scan passed 0
qdrant-edge

Guides building on Qdrant Edge, the embedded in-process shard. Use when someone asks 'how to sync Edge with the server', 'keep a local shard in sync with Qdrant Cloud', 'BM25 or keyword search on Edge', 'hybrid search on Edge', 'embeddings on device', 'Edge snapshots', 'apply a partial snapshot', 'w

Scan passed 0
qdrant-horizontal-scaling

Diagnoses and guides Qdrant horizontal scaling decisions. Use when someone asks 'vertical or horizontal?', 'how many nodes?', 'how many shards?', 'how to add nodes', 'resharding', 'data doesn't fit', or 'need more capacity'. Also use when data growth outpaces current deployment.

Scan passed 0
qdrant-hybrid-cloud-setup

Setting up and running Qdrant Hybrid Cloud on your own Kubernetes cluster (managed, on-prem, or edge): prerequisites, storage/CSI and backups, installing the Qdrant Cloud agent and operator, creating/exposing/securing clusters, registry mirroring, and secret rotation. Use when someone wants to set u

Scan passed 0
qdrant-hybrid-search

Explains hybrid search in Qdrant. Use when someone asks 'how do I setup hybrid search?', 'how to combine keyword and semantic search?', 'sparse plus dense vectors?', 'missing keyword matches', 'how to combine results from multiple searches?' and 'combining multiple representations'. Also use for how

Scan passed 0
qdrant-hybrid-search-combining

Fusing scores from multiple searches into a single ranked result (RRF, DBSF, custom fusion). Use when someone asks 'RRF or DBSF?', 'how to combine sparse and dense', 'how to combine scores from multiple searches?', 'custom fusion', 'fusion is not producing good results', 'how do I tune RRF', 'what k

Scan passed 0
qdrant-hybrid-search-prefetches

Constructing prefetch queries for hybrid retrieval, including sparse/dense and multi-field setups, and choosing a sparse embedding model. Use when someone asks 'dense and sparse in one search?', 'how to combine multiple fields for retrieval?', 'payloads or sparse vectors for lexical?', 'which sparse

Scan passed 0

Related backend skillsscan passed