[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-qdrant-qdrant-version-upgrade":3,"mdc-dlgaaw-key":46,"related-repo-qdrant-qdrant-version-upgrade":118,"related-org-qdrant-qdrant-version-upgrade":218},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":41,"sourceUrl":44,"mdContent":45},"qdrant-version-upgrade","upgrade Qdrant database versions","Guidance on how to upgrade your Qdrant version without interrupting the availability of your application and ensuring data integrity.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"qdrant","Qdrant","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fqdrant.png",[12,14,17],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"Database","database",{"name":18,"slug":19,"type":13},"Migration","migration",197,"https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fskills","2026-07-19T05:38:37.330561",null,23,[26,27,28,29,30,31,32,33,34,35,8,36,37,38,39,40],"agent-skills","ai-agents","claude-code","codex","cursor","embeddings","hybrid-search","monitoring","multitenancy","performance","quantization","scaling","search-quality","vector-database","vector-search",{"repoUrl":21,"stars":20,"forks":24,"topics":42,"description":43},[26,27,28,29,30,31,32,33,34,35,8,36,37,38,39,40],"Agent skills for Qdrant vector search: scaling, performance optimization, search quality, monitoring, deployment, model migration, version upgrades, and SDK usage across Python, TypeScript, Rust, Go, .NET, Java","https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fqdrant-version-upgrade","---\nname: qdrant-version-upgrade\ndescription: \"Guidance on how to upgrade your Qdrant version without interrupting the availability of your application and ensuring data integrity.\"\n---\n\n\n# Qdrant Version Upgrade\n\nQdrant has the following guarantees about version compatibility:\n\n- Major and minor versions of Qdrant and SDK are expected to match. For example, Qdrant 1.17.x is compatible with SDK 1.17.x.\n\n- Qdrant is tested for backward compatibility between minor versions. For example, Qdrant 1.17.x should be compatible with SDK 1.16.x. Qdrant server 1.16.x is also expected to be compatible with SDK 1.17.x, but only for the subset of features that were available in 1.16.x.\n\n- For migration to the next minor version, it is recommended to first upgrade the SDK to the next minor version and then upgrade the Qdrant server.\n\n- Storage compatibility is only guaranteed for one minor version. For example, data stored with Qdrant 1.16.x is expected to be compatible with Qdrant 1.17.x. If you need to migrate more than one minor version, it is required do the upgrade step by step, one minor version at a time. For example, to migrate from 1.15.x to 1.17.x, you need to first upgrade to 1.16.x and then to 1.17.x. Note: Qdrant Cloud automates this process, so you can directly upgrade from 1.15.x to 1.17.x without intermediate steps.\n\n- A Qdrant cluster with a replication factor of 2 or higher can be upgraded without downtime by performing a rolling upgrade. This means that you can upgrade one node at a time while the other nodes continue to serve requests. This allows you to maintain availability of your application during the upgrade process. More about replication factor: [Replication factor](https:\u002F\u002Fskills.qdrant.tech\u002Fmd\u002Fdocumentation\u002Fscaling\u002Fdistributed_deployment\u002F?s=replication-factor)\n\nFor managing Qdrant version upgrades in Qdrant Cloud, you can use the [qcloud](https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqcloud-cli) CLI tool.\n",{"data":47,"body":48},{"name":4,"description":6},{"type":49,"children":50},"root",[51,59,65,104],{"type":52,"tag":53,"props":54,"children":55},"element","h1",{"id":4},[56],{"type":57,"value":58},"text","Qdrant Version Upgrade",{"type":52,"tag":60,"props":61,"children":62},"p",{},[63],{"type":57,"value":64},"Qdrant has the following guarantees about version compatibility:",{"type":52,"tag":66,"props":67,"children":68},"ul",{},[69,75,80,85,90],{"type":52,"tag":70,"props":71,"children":72},"li",{},[73],{"type":57,"value":74},"Major and minor versions of Qdrant and SDK are expected to match. For example, Qdrant 1.17.x is compatible with SDK 1.17.x.",{"type":52,"tag":70,"props":76,"children":77},{},[78],{"type":57,"value":79},"Qdrant is tested for backward compatibility between minor versions. For example, Qdrant 1.17.x should be compatible with SDK 1.16.x. Qdrant server 1.16.x is also expected to be compatible with SDK 1.17.x, but only for the subset of features that were available in 1.16.x.",{"type":52,"tag":70,"props":81,"children":82},{},[83],{"type":57,"value":84},"For migration to the next minor version, it is recommended to first upgrade the SDK to the next minor version and then upgrade the Qdrant server.",{"type":52,"tag":70,"props":86,"children":87},{},[88],{"type":57,"value":89},"Storage compatibility is only guaranteed for one minor version. For example, data stored with Qdrant 1.16.x is expected to be compatible with Qdrant 1.17.x. If you need to migrate more than one minor version, it is required do the upgrade step by step, one minor version at a time. For example, to migrate from 1.15.x to 1.17.x, you need to first upgrade to 1.16.x and then to 1.17.x. Note: Qdrant Cloud automates this process, so you can directly upgrade from 1.15.x to 1.17.x without intermediate steps.",{"type":52,"tag":70,"props":91,"children":92},{},[93,95],{"type":57,"value":94},"A Qdrant cluster with a replication factor of 2 or higher can be upgraded without downtime by performing a rolling upgrade. This means that you can upgrade one node at a time while the other nodes continue to serve requests. This allows you to maintain availability of your application during the upgrade process. More about replication factor: ",{"type":52,"tag":96,"props":97,"children":101},"a",{"href":98,"rel":99},"https:\u002F\u002Fskills.qdrant.tech\u002Fmd\u002Fdocumentation\u002Fscaling\u002Fdistributed_deployment\u002F?s=replication-factor",[100],"nofollow",[102],{"type":57,"value":103},"Replication factor",{"type":52,"tag":60,"props":105,"children":106},{},[107,109,116],{"type":57,"value":108},"For managing Qdrant version upgrades in Qdrant Cloud, you can use the ",{"type":52,"tag":96,"props":110,"children":113},{"href":111,"rel":112},"https:\u002F\u002Fgithub.com\u002Fqdrant\u002Fqcloud-cli",[100],[114],{"type":57,"value":115},"qcloud",{"type":57,"value":117}," CLI tool.",{"items":119,"total":217},[120,135,150,165,180,194,207],{"slug":121,"name":121,"fn":122,"description":123,"org":124,"tags":125,"stars":20,"repoUrl":21,"updatedAt":134},"qdrant-advisor","diagnose and troubleshoot Qdrant deployments","Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech. Use this whenever someone raises a Qdrant problem or question — slow or degraded search, high or growing memory \u002F OOM crashes, optimizer stuck or slow, indexing slowness, scaling and sharding decisions (node count, QPS, latency, multitenancy, vertical vs horizontal), poor or irrelevant search results, hybrid search and reranking, embedding-model migration, version upgrades and compatibility, monitoring and observability (Prometheus, Grafana, health checks, \u002Fmetrics, \u002Ftelemetry), deployment choices (local, Docker, self-hosted, Qdrant Cloud, embedded), or client-SDK questions (Python, TypeScript, Rust, Go, .NET, Java). Trigger especially when the context is clearly a Qdrant cluster, collection, or vector-search deployment. Always prefer this skill over answering from memory: it pulls current, authoritative guidance and only the relevant context.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[126,127,130,133],{"name":15,"slug":16,"type":13},{"name":128,"slug":129,"type":13},"Debugging","debugging",{"name":131,"slug":132,"type":13},"Operations","operations",{"name":9,"slug":8,"type":13},"2026-07-16T06:02:56.675293",{"slug":136,"name":136,"fn":137,"description":138,"org":139,"tags":140,"stars":20,"repoUrl":21,"updatedAt":149},"qdrant-clients-sdk","integrate Qdrant client SDKs","Qdrant provides client SDKs for various programming languages, allowing easy integration with Qdrant deployments.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[141,144,145,146],{"name":142,"slug":143,"type":13},"API Development","api-development",{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":147,"slug":148,"type":13},"SDK","sdk","2026-07-16T05:59:57.799789",{"slug":151,"name":151,"fn":152,"description":153,"org":154,"tags":155,"stars":20,"repoUrl":21,"updatedAt":164},"qdrant-deployment-options","select 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 project.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[156,157,160,163],{"name":15,"slug":16,"type":13},{"name":158,"slug":159,"type":13},"Deployment","deployment",{"name":161,"slug":162,"type":13},"Infrastructure","infrastructure",{"name":9,"slug":8,"type":13},"2026-07-19T05:38:33.324265",{"slug":166,"name":166,"fn":167,"description":168,"org":169,"tags":170,"stars":20,"repoUrl":21,"updatedAt":179},"qdrant-edge","build applications with 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', 'why is my Edge search empty after inserts', or is writing custom sync, BM25, or fusion code against qdrant-edge. Also use when deciding what Edge ships built-in versus what you must implement.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[171,172,175,176],{"name":15,"slug":16,"type":13},{"name":173,"slug":174,"type":13},"Edge","edge",{"name":9,"slug":8,"type":13},{"name":177,"slug":178,"type":13},"Search","search","2026-07-16T06:01:19.179105",{"slug":181,"name":181,"fn":182,"description":183,"org":184,"tags":185,"stars":20,"repoUrl":21,"updatedAt":193},"qdrant-horizontal-scaling","guide Qdrant horizontal scaling decisions","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.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[186,189,190,191],{"name":187,"slug":188,"type":13},"Architecture","architecture",{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":192,"slug":37,"type":13},"Scaling","2026-07-19T05:38:32.348551",{"slug":195,"name":195,"fn":196,"description":197,"org":198,"tags":199,"stars":20,"repoUrl":21,"updatedAt":206},"qdrant-hybrid-search","implement hybrid search in Qdrant","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'",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[200,203,204,205],{"name":201,"slug":202,"type":13},"AI Infrastructure","ai-infrastructure",{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":177,"slug":178,"type":13},"2026-07-16T06:00:12.328122",{"slug":208,"name":208,"fn":209,"description":210,"org":211,"tags":212,"stars":20,"repoUrl":21,"updatedAt":216},"qdrant-hybrid-search-combining","combine hybrid search scores in Qdrant","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', or 'fusion is not producing good results'",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[213,214,215],{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":177,"slug":178,"type":13},"2026-07-16T06:01:49.401142",30,{"items":219,"total":217},[220,227,234,241,248,255,262,268,279,291,301,312],{"slug":121,"name":121,"fn":122,"description":123,"org":221,"tags":222,"stars":20,"repoUrl":21,"updatedAt":134},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[223,224,225,226],{"name":15,"slug":16,"type":13},{"name":128,"slug":129,"type":13},{"name":131,"slug":132,"type":13},{"name":9,"slug":8,"type":13},{"slug":136,"name":136,"fn":137,"description":138,"org":228,"tags":229,"stars":20,"repoUrl":21,"updatedAt":149},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[230,231,232,233],{"name":142,"slug":143,"type":13},{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":147,"slug":148,"type":13},{"slug":151,"name":151,"fn":152,"description":153,"org":235,"tags":236,"stars":20,"repoUrl":21,"updatedAt":164},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[237,238,239,240],{"name":15,"slug":16,"type":13},{"name":158,"slug":159,"type":13},{"name":161,"slug":162,"type":13},{"name":9,"slug":8,"type":13},{"slug":166,"name":166,"fn":167,"description":168,"org":242,"tags":243,"stars":20,"repoUrl":21,"updatedAt":179},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[244,245,246,247],{"name":15,"slug":16,"type":13},{"name":173,"slug":174,"type":13},{"name":9,"slug":8,"type":13},{"name":177,"slug":178,"type":13},{"slug":181,"name":181,"fn":182,"description":183,"org":249,"tags":250,"stars":20,"repoUrl":21,"updatedAt":193},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[251,252,253,254],{"name":187,"slug":188,"type":13},{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":192,"slug":37,"type":13},{"slug":195,"name":195,"fn":196,"description":197,"org":256,"tags":257,"stars":20,"repoUrl":21,"updatedAt":206},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[258,259,260,261],{"name":201,"slug":202,"type":13},{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":177,"slug":178,"type":13},{"slug":208,"name":208,"fn":209,"description":210,"org":263,"tags":264,"stars":20,"repoUrl":21,"updatedAt":216},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[265,266,267],{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":177,"slug":178,"type":13},{"slug":269,"name":269,"fn":270,"description":271,"org":272,"tags":273,"stars":20,"repoUrl":21,"updatedAt":278},"qdrant-hybrid-search-prefetches","configure hybrid search with prefetch queries","Constructing prefetch queries for hybrid retrieval, including sparse\u002Fdense 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 embedding model to use?', or 'BM25 vs SPLADE?'",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[274,275,276,277],{"name":142,"slug":143,"type":13},{"name":15,"slug":16,"type":13},{"name":9,"slug":8,"type":13},{"name":177,"slug":178,"type":13},"2026-07-16T06:03:02.305907",{"slug":280,"name":280,"fn":281,"description":282,"org":283,"tags":284,"stars":20,"repoUrl":21,"updatedAt":290},"qdrant-indexing-performance-optimization","optimize Qdrant indexing and data ingestion","Diagnoses and fixes slow Qdrant indexing and data ingestion. Use when someone reports 'uploads are slow', 'indexing takes forever', 'optimizer is stuck', 'HNSW build time too long', or 'data uploaded but search is bad'. Also use when optimizer status shows errors, segments won't merge, or indexing threshold questions arise.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[285,286,287,289],{"name":15,"slug":16,"type":13},{"name":128,"slug":129,"type":13},{"name":288,"slug":35,"type":13},"Performance",{"name":9,"slug":8,"type":13},"2026-07-19T05:38:36.321999",{"slug":292,"name":292,"fn":293,"description":294,"org":295,"tags":296,"stars":20,"repoUrl":21,"updatedAt":300},"qdrant-memory-usage-optimization","optimize Qdrant memory usage","Diagnoses and reduces Qdrant memory usage. Use when someone reports 'memory too high', 'RAM keeps growing', 'node crashed', 'out of memory', 'memory leak', or asks 'why is memory usage so high?', 'how to reduce RAM?'. Also use when memory doesn't match calculations, quantization didn't help, or nodes crash during recovery.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[297,298,299],{"name":128,"slug":129,"type":13},{"name":288,"slug":35,"type":13},{"name":9,"slug":8,"type":13},"2026-07-16T06:00:15.357243",{"slug":302,"name":302,"fn":303,"description":304,"org":305,"tags":306,"stars":20,"repoUrl":21,"updatedAt":311},"qdrant-minimize-latency","optimize Qdrant query latency","Guides Qdrant query latency optimization. Use when someone asks 'search is slow', 'how to reduce latency', 'p99 is too high', 'tail latency', 'single query too slow', 'how to make search faster', or 'latency spikes'.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[307,308,309,310],{"name":15,"slug":16,"type":13},{"name":128,"slug":129,"type":13},{"name":288,"slug":35,"type":13},{"name":9,"slug":8,"type":13},"2026-07-16T05:59:17.325839",{"slug":313,"name":313,"fn":314,"description":315,"org":316,"tags":317,"stars":20,"repoUrl":21,"updatedAt":322},"qdrant-model-migration","migrate embedding models in Qdrant","Guides embedding model migration in Qdrant without downtime. Use when someone asks 'how to switch embedding models', 'how to migrate vectors', 'how to update to a new model', 'zero-downtime model change', 'how to re-embed my data', or 'can I use two models at once'. Also use when upgrading model dimensions, switching providers, or A\u002FB testing models.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[318,319,320,321],{"name":15,"slug":16,"type":13},{"name":18,"slug":19,"type":13},{"name":288,"slug":35,"type":13},{"name":9,"slug":8,"type":13},"2026-07-16T06:00:48.841055"]