Commit Graph
166 Commits
Author SHA1 Message Date
István Zoltán Szabó 507e29fae2 Put localhost back. 2026-07-21 11:45:33 +02:00
István Zoltán Szabó 5b61a30535 Create code snippets for distributed deployment. 2026-07-20 17:06:30 +02:00
Abdon PijpelinkandClaude Sonnet 4.6 78a099c37f docs(ops-monitoring): add Datadog monitoring tutorial for hybrid/private cloud (#2442)
Adds a step-by-step tutorial for setting up the Datadog Operator and Agent
to scrape Qdrant metrics via OpenMetrics in Kubernetes-based Hybrid Cloud
and Private Cloud deployments, and links it from the section index and the
operations tutorials table.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-15 15:52:04 +02:00
Dylan Couzon 5d19e6cdd0 add tutorial 2026-07-08 17:08:58 -04:00
Abdon Pijpelink 757767919b Add 'Mitigate Read-Write Contention' section to the bulk upload guide (#2469)
* Change bulk upload from tutorial into guide

* Add 'Mitigate Read-Write Contention' section to bulk upload guide

* Update meta descriptions
2026-07-06 10:02:00 +02:00
Abdon Pijpelink cf4119fa3f Add subsection about stable ordering to pagination section (#2463)
* Add 'Stable Ordering' section to 'Pagination' section

* Add FAQ entry

* Small edits to the Pagination section

* Apply title case to all headers on page

* Small edit
2026-06-30 13:07:43 +02:00
Abdon Pijpelink 708c40573d Include imports in Edge Rust snippets (#2437)
* Allow rust code snippets to start with a comment line

* Include imports in Edge Rust snippets

* Add import per code block; use fqn when class name is ambiguous
2026-06-29 15:39:06 +02:00
Abdon Pijpelink 44bf1f472b Update Bulk Upload tutorial for best practices (#2407)
* Make Bulk Upload tutorial code snippets testable

* Align Bulk Upload tutorial with agent skill

* Update Bulk Upload tutorial

* Update title

* Remove 'Disable Indexing' section
2026-06-26 13:07:14 +02:00
Abdon PijpelinkandClaude Sonnet 4.6 478b96554f Restructure inference docs (#2225)
* Break Inference page into several pages

* Make all inference code snippets testable and clean up

* Make more snippets testable

* Edits

* Document automatic query and passage prefix injection in Cloud Inference

Qdrant Cloud Inference silently applies model-specific prefixes (e.g.
"query: "/"passage: " for E5, BGE-style instruction prefix for BGE/mxbai/
Snowflake arctic-embed) so users don't need to manage them manually.
Add a section explaining this behavior, the idempotency guarantee, and
the scope (Qdrant-hosted models only; external providers handle their own).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Document short query optimization in Cloud Inference

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Update links

* Expand on external provider API key usage

* Add section about external provider API keys

* Default to header for external API keys

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-24 08:11:03 +02:00
Kirstin ffb667d1b8 Merge pull request #2438 from qdrant/szabosteve/blue-green
Add blue-green cluster deployment tutorial
2026-06-23 16:56:10 +02:00
Abdon Pijpelink 7590063d83 Read-write contention troubleshooting guide (#2421)
* New r/w contention troubleshooting guide

* Add snippet to low latency search guide

* Add FAQ entry

* Add 'Read More' section to guide
2026-06-23 16:04:13 +02:00
István Zoltán Szabó f96721efda Add blue-green cluster deployment tutorial. 2026-06-22 15:17:56 +02:00
Abdon PijpelinkandClaude Sonnet 4.6 ffe50340fa Edge 0.7 documentation updates (#2391)
* docs(edge): add "Modify the Vector Schema" step to quickstart

Documents the new Edge 0.7 API for adding and removing named vector
fields on an existing shard without recreating it, with Python and
Rust snippets.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(edge): mention quantization support in quickstart

Adds a note after the EdgeConfig snippet that Edge supports all four
quantization methods (Scalar, Product, Binary, TurboQuant), with a
link to the quantization guide.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(edge): add On-Device BM25 page for Edge 0.7

New guide covering the built-in BM25 sparse embedder: configuring a
sparse vector shard, creating a Bm25/EdgeBm25 embedder, embedding and
upserting documents, and querying. Includes Python and Rust snippets.
Also adds the page to the Edge index navigation table.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(edge): add WAL segment size configuration to quickstart

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Upgrade code snippets to Edge 0.7.2

* Review feedback

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-03 15:51:20 +02:00
9ba29ff4fa New tutorial: "Secure a Self-Hosted Qdrant Instance" (#2385)
* Initial commit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Edits

* Edits

* Fix links

* Use 'true' instead of '1' in QDRANT__SERVICE__ENABLE_TLS example

* Review feedback

* Add link from Security page

* Update stack designation on overview page

* Update qdrant-landing/content/documentation/tutorials-operations/secure-qdrant.md

Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>
2026-06-01 16:09:56 +02:00
Dylan Couzon 829e187767 Merge pull request #2380 from qdrant/git-indexing
add: Branch-Aware Search
2026-05-29 12:17:42 -04:00
Dylan Couzon 26ea463cf1 new design 2026-05-28 00:19:34 -04:00
Abdon PijpelinkandClaude Sonnet 4.6 72ea635755 Update Security docs (#2368)
* Rewrite security page intro to be feature-forward

Replaces the generic opening paragraph with one that names each security
feature (API key auth, read-only keys, JWT RBAC, network binding, TLS,
audit logging) and links directly to their sections, so scanning readers
see the full capability surface before hitting the warning block.

Also updates the checklist items to surface read-only keys and JWT RBAC
as explicit options under Authentication.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Add Security FAQ section to Qdrant Fundamentals

Adds three new Q&A entries covering default security posture, read-only
API keys, and JWT collection-scoped access control — the exact questions
users ask in Discord. Also adds Security to the page nav table and fixes
the heading depth on the collection-per-user entry (## → ###).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Add Security section to production checklist

Inserts a new section 2 covering the five key security steps — API key
auth, read-only keys, JWT access control, TLS, and network binding —
with direct links to the Security page. Renumbers existing sections
2–4 to 3–5. Closes the gap where a user following the checklist
step-by-step could go to production with an open, unauthenticated instance.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Link production checklist from both quickstart pages

Adds a production checklist callout to the "Next Steps" section of the
local quickstart and a bullet to the "What's Next?" section of the cloud
quickstart, so users completing either tutorial have a clear path to
production readiness.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Make code snippets testable

* Lead Security page by listing all the features; Rename API keys->Admin API keys, and 'Granular Access Control with JWT' section into 'Granular Access API Keys'

* Update links

* Update meta description

* Fix C# snippet

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-27 15:56:52 +02:00
Dylan Couzon 7b20d2ec9e add navigation links 2026-05-26 19:19:47 -04:00
Abdon Pijpelink 04e3e0bb1d Add named vectors scenario to embedding migration tutorial (#2348)
* Initial commit

* Edits

* Update FAQ

* Edits

* Mention required versions
2026-05-26 09:38:24 +02:00
Dylan Couzon e6f688d10a Merge pull request #2362 from qdrant/with_lookup-example
Add with_lookup example
2026-05-21 11:04:34 -04:00
Dylan Couzon 844042032f Merge pull request #2357 from qdrant/hybrid-search-gap-3
Document fusion methods: weighted RRF, DBSF, FormulaQuery
2026-05-20 12:48:26 -04:00
Dylan CouzonandClaude Opus 4.7 bbb09d9310 Give chunk 1 array document_id in ingest example
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 12:35:05 -04:00
Dylan CouzonandClaude Opus 4.7 0ead6b8f8b Disambiguate document ids in with_lookup example
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 11:35:38 -04:00
Abdon PijpelinkandTim Visée cf94245089 Increase payload indexing advice visibility (#2360)
* Add new 'Create a Payload Index' section

* Add indexing tip to low latency search, search, and filtering docs

* Add bash code snippet

* Edits

* Update qdrant-landing/content/documentation/manage-data/indexing.md

Co-authored-by: Tim Visée <tim@visee.me>

---------

Co-authored-by: Tim Visée <tim@visee.me>
2026-05-20 10:05:33 +02:00
Dylan CouzonandClaude Opus 4.7 a6104d7b7a Add worked with_lookup example
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 19:08:36 -04:00
Abdon Pijpelink 97b3a05c5f Reorganize search tutorials (#2352)
* Restructure search tutorials

* Deleted moved tutorial

* Re-instate deleted frontmatter

* Fix links to moved files

* Move code search and build tutorials to 'Develop&Implement' section

* Update landing pages too

* Fix broken links
2026-05-19 16:38:52 +02:00
Dylan CouzonandClaude Opus 4.7 c0128a53bc Apply adversarial-review fixes to hybrid-queries and snippets
Address findings from a code-bot adversarial review of the hybrid-search
materials:

- `hybrid-formula-decay/` (all 7 language sources + http.md +
  `_description.md`): wrap the decay term in `MultExpression(mult=[0.1, ...])`
  in every language. Previously the snippets summed `$score` with
  `ExpDecayExpression` directly, modeling the failure mode the docs
  explicitly warn against (un-weighted decay crowds out small RRF scores).
  Also document the `defaults` requirement and the recommended datetime
  payload index in `_description.md`. Build validated across all 6 SDKs.

- `hybrid-rrf/go.go`: add `Limit: qdrant.PtrOf(uint64(20))` to both
  prefetches so the Go snippet matches the other language tabs.

- `hybrid-queries.md`:
  - Reframe the weighted-RRF intro to drop "semantic search model
    understands meaning better than a simple keyword matcher". On
    SciFact (the corpus in the companion notebook) BM25 actually beats
    dense, so the universal claim was contradicted by our own data.
  - Clarify that the notebook provides a tuning helper to adapt to a
    train/val split, not that it demonstrates the split itself.
  - Add a one-line note that Qdrant uses zero-based rank positions so
    readers can verify the RRF formula against actual scores.
  - Apply brand-voice fixes: Title Case on "Multi-Stage Queries" and
    "Re-Scoring Examples", replace "all the above techniques" with
    "all of these techniques".

`generated/*.md` regenerated via `./docker.sh ./generate-md.py`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 21:54:47 -04:00
Dylan CouzonandClaude Opus 4.7 fc299a0e9c Switch hybrid-rrf snippets to RrfQuery API
Replaces the older `FusionQuery(fusion=Fusion.RRF)` enum form with
`RrfQuery(rrf=Rrf())` across all language tabs (Python, TypeScript,
Rust, Go, Java, C#) plus the REST body in `http.md`, for both the
`hybrid-rrf/` snippet and the inner RRF prefetch inside
`hybrid-formula-decay/`. The newer dedicated `Rrf` message is the
recommended path going forward; the old enum stays supported for
backward compatibility. Server-side both forms converge to the same
`FusionInternal::Rrf { k: 2, weights: None }`, verified against the
qdrant/qdrant source.

`generated/*.md` files in both directories regenerated via
`./docker.sh ./generate-md.py`. `./docker.sh ./check.py build` passes
across all six SDKs.

Also softens the DBSF prose in hybrid-queries.md to drop the
"weighted RRF tends to win" framing. Neither method dominates the
other in general.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 21:04:09 -04:00
Dylan Couzon 8cdce983ed upload snippets 2026-05-15 16:49:56 -04:00
Dylan Couzon 1d36116d77 Merge pull request #2334 from qdrant/hybrid-search-gap-2
Multi-representation search tutorial + supporting doc cross-links
2026-05-15 14:17:28 -04:00
brone1323andAbdon Pijpelink 5aa98e5959 fix(docs): correct C# MatchExcept snippet (was using Match instead of MatchExcept) (#2345)
* fix(docs): correct C# MatchExcept snippet to use MatchExcept instead of Match

The C# code example in the match-except filter condition snippet was
incorrectly using Match() instead of MatchExcept(), making it identical
to the match-any example. This is misleading for developers trying to
implement the MatchExcept (NOT IN) filter condition in C#.

Fixes #1656

* Add Markdownified code snippet

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-05-12 10:26:57 +02:00
Dylan Couzon d21b5a5435 Merge pull request #2305 from qdrant/retrival-quality-guide-improvement
docs(tutorials): split retrieval-quality into three evaluation layers
2026-05-11 11:55:53 -04:00
Abdon Pijpelink cba308dc31 Fix tracing ID Python snippet import 2026-05-11 11:32:10 +02:00
46e81449a8 Add TurboQuant quantization documentation (v1.18.0) (#2313)
* Add TurboQuant quantization documentation (v1.18.0)

Adds a new TurboQuant section to the quantization guide covering the
four encoding options (bits1/bits1_5/bits2/bits4), automatic asymmetric
quantization, distance metric support, and the automatic TQ+ precision
enhancement for sealed segments. Updates the comparison table and
method-selection guidance to recommend TurboQuant over Binary and
Scalar Quantization for new collections. Adds HTTP-only snippets for
basic setup and explicit bit-depth selection.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Consistently use title case for headers

* Restructure doc to lead with TurboQuant

* Clarify rescoring

* Edits

* Soften TQ advice

* Updates

* Fix

* Apply suggestions from code review

Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>

* Review feedback

* Add Go/Java/C# code snippets

* Add list of 4 quantization methods to introduction

* Review feedback

* Stronger advice for TQ4

* Add Python snippets

* Add Rust snippets

* Add TS snippets

* Update recommendation table

* Update production checklist

* Remove link to article

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>
2026-05-11 08:13:03 +02:00
Abdon Pijpelink 506639965d Add Rust snippets for adding/removing named vectors 2026-05-07 10:25:37 +02:00
Abdon Pijpelink cb585a1fce Add TS snippets for adding/removing named vectors 2026-05-07 09:46:50 +02:00
Abdon Pijpelink 483b384421 Add Python snippets 2026-05-07 09:36:00 +02:00
Dylan Couzon 67ebec2831 add sidebar + menu references 2026-05-05 09:57:35 -04:00
Abdon Pijpelink 46fc4f0350 Add Go/Java/C# snippets for named vector CRUD 2026-05-04 14:44:48 +02:00
Abdon Pijpelink 0fc11c07de Documentation for the Query Audit Logs API (#2232)
* Documentation for the Query Audit Logs API

* Add missing empty request body

* Review feedback
2026-05-04 13:33:57 +02:00
Dylan CouzonandClaude Opus 4.7 9fbcd1adad Rename retrieval-quality slugs to match tutorial scope
Tutorial slugs now match their content:
- retrieval-quality/ -> ann-recall/ (alias preserves the old published path)
- retrieval-quality-golden-set/ -> retrieval-relevance/
- retrieval-quality-pipeline-output/ -> pipeline-output-quality/

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 16:32:46 -04:00
ecd4887576 Document new strict_mode_config parameters (v1.18.0) (#2303)
* Document 7 missing strict_mode_config parameters

Adds documentation sections and code snippets (Python, TypeScript, Rust,
Go, Java, C#, HTTP, bash) for search_allow_exact, search_max_hnsw_ef,
search_max_oversampling, search_max_batchsize, max_resident_memory_percent,
multivector_config, and sparse_config.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Use title case for all headers

* Update qdrant-landing/content/documentation/ops-configuration/administration.md

Co-authored-by: Tim Visée <tim@visee.me>

* Mention default strict mode on Cloud; Clarify behavior of only setting enabled=true

* Apply suggestion from @timvisee

Co-authored-by: Tim Visée <tim@visee.me>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Tim Visée <tim@visee.me>
2026-04-30 20:25:21 +02:00
Dylan CouzonandClaude Opus 4.7 33bd663d80 Move retrieval relevance and pipeline-output tutorials to Improve Search
Splits the three retrieval-evaluation tutorials across two sections.
ANN Recall (Web UI, language-agnostic) stays under Search Engineering.
The two Python ecosystem tutorials (ranx, ragas) move to a new top-level
Improve Search section under the Ecosystem partition.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 12:30:08 -04:00
Abdon Pijpelink 10b98c3ca2 Docs for adding/removing named vectors (#2282)
* Initial commit

* Switch to title case for Collections page

* Move to Collections page

* One more clarification

* Update section title
2026-04-30 09:03:48 +02:00
Dylan CouzonandClaude Opus 4.7 9f4b4c05ea Rename ANN precision tutorial to ANN recall
Recall@k is the standard metric for ANN benchmarks. Rename the
tutorial title, headings, helper function, and prose; update the
recent inline edits and merge sentence; and update cross-links from
the relevance and pipeline-output tutorials and the tutorials index.
Generic Precision@k mentions in the ranx metric list are unrelated
and left alone.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 15:00:06 -04:00
Dylan CouzonandClaude Opus 4.7 6c10996b66 rename Building a Golden Query Set to Measuring Retrieval Relevance
Aligns the layer-2 tutorial title with the parallel "Measuring X" /
"Evaluating X" pattern used by the other two and maps directly to the
four-layer framework. Slug stays the same to preserve URLs and the
golden-set artifact identity in the path. Also updates the nav descriptions
to reflect the tutorial's full scope (build + score, not just build).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 23:29:44 -04:00
Dylan CouzonandClaude Opus 4.7 e02bfb0bf1 delete retrieval-quality-fundamentals and remove from nav indexes
The four-layer framework, metric-selection table, and business-impact
guidance now live inside the three execution tutorials. The fundamentals
page is no longer needed as a shared reference and readers don't have to
leave the tutorial flow to get context.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 23:22:40 -04:00
Dylan Couzon 7a4129be1e add third guide + update indices 2026-04-23 20:23:10 -04:00
Dylan Couzon 1fbc73c4b2 Merge branch 'master' into retrival-quality-guide-improvement 2026-04-23 12:24:29 -04:00
Dylan Couzon 340c6528ca Clean up, tone 2026-04-23 11:06:18 -04:00