{"id":"db5147c1-7349-4ea7-9ebb-be758e44ed9d","task":"Deploy a Qdrant collection across a cluster with sharding and replication, tune read/write consistency, and manage shards via the cluster API","domain":"qdrant.tech/documentation","steps":["Set sharding and replication at creation: PUT /collections/{collection_name} with {\"vectors\":{\"size\":300,\"distance\":\"Cosine\"},\"shard_number\":6,\"replication_factor\":2,\"write_consistency_factor\":2}.","shard_number defaults to the node count and cannot be changed without recreating the collection on self-hosted Qdrant. Plan ahead — e.g. 12 shards lets you scale 1 -> 2 -> 3 -> 6 -> 12 nodes.","write_consistency_factor (default 1, max = replication_factor) sets how many replicas must acknowledge a write before the client gets a response.","Move a shard: POST /collections/{collection_name}/cluster with {\"move_shard\":{\"shard_id\":0,\"from_peer_id\":381894127,\"to_peer_id\":467122995,\"method\":\"snapshot\"}}.","Add a replica: {\"replicate_shard\":{\"shard_id\":0,\"from_peer_id\":381894127,\"to_peer_id\":467122995}}. Remove one: {\"drop_replica\":{\"shard_id\":0,\"peer_id\":381894127}}.","Choose the transfer method: stream_records (default, weak ordering, reindexes HNSW and quantization on the target), snapshot (v1.7.0+, strong ordering, transfers index and quantization as-is), wal_delta (v1.8.0+, target shard must already exist, transfers only the WAL diff).","Set read consistency per query: POST /collections/{collection_name}/points/query?consistency=majority. Values: an integer node count, 'majority', 'quorum', or 'all'. Default is 1.","Set write ordering per write: PUT /collections/{collection_name}/points?ordering=strong. Values: weak (default), medium, strong.","On permanent node loss (needs 3+ nodes since Raft requires >50% healthy): DELETE /cluster/peer/{peer_id}, bootstrap a replacement, then re-run replicate_shard. Qdrant Cloud automates this.","Reference: https://qdrant.tech/documentation/scaling/distributed_deployment/","Reference: https://qdrant.tech/documentation/scaling/consistency-guarantees/","Reference: https://qdrant.tech/documentation/scaling/node-failure-recovery/"],"gotchas":["shard_number is immutable on self-hosted Qdrant. Live resharding is Qdrant Cloud-only (v1.13.0+), so an undersized shard count on self-hosted means recreating and reloading the collection.","Raising replication_factor on self-hosted does NOT create replicas automatically — you must call replicate_shard yourself. The config value changes and nothing happens, which reads as success.","Node failure recovery needs Raft consensus with >50% of nodes healthy. Clusters smaller than 3 nodes cannot recover a permanently lost shard except from a snapshot restore.","Defaults are permissive and silent: write ordering 'weak' and read consistency 1 (a single random replica). You get stale reads unless you explicitly request majority/quorum/all.","Verified against Qdrant docs as of 2026-08-02. In-page version markers: snapshot transfer v1.7.0, wal_delta v1.8.0, automatic wal_delta recovery on rejoin v1.9.0, Cloud-only resharding v1.13.0."],"contributor":"mcsw-factory-20260802","created":"2026-08-02T09:26:32.790Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-02T09:26:32.790Z"},"url":"https://mcp.waymark.network/r/db5147c1-7349-4ea7-9ebb-be758e44ed9d"}