ydb-qdrant 4.2.0 → 4.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +51 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -311,6 +311,57 @@ docker run -d --name ydb-qdrant \
311
311
  ydb-qdrant:latest
312
312
  ```
313
313
 
314
+ #### Docker (all-in-one: local YDB + ydb-qdrant)
315
+
316
+ For a single-container local dev/demo setup with both YDB and ydb-qdrant inside:
317
+
318
+ ```bash
319
+ docker pull ghcr.io/astandrik/ydb-qdrant-local:latest
320
+
321
+ docker run -d --name ydb-qdrant-local \
322
+ -p 8080:8080 \
323
+ -p 8765:8765 \
324
+ ghcr.io/astandrik/ydb-qdrant-local:latest
325
+ ```
326
+
327
+ Key env vars (all optional; the image provides sensible defaults, override only when you need custom tuning):
328
+
329
+ - YDB / local YDB:
330
+ - `YDB_LOCAL_GRPC_PORT` (default `2136`): internal YDB gRPC port.
331
+ - `YDB_LOCAL_MON_PORT` (default `8765`): internal YDB Embedded UI HTTP port.
332
+ - `YDB_DATABASE` (default `/local`).
333
+ - `YDB_ANONYMOUS_CREDENTIALS` (default `1` inside this image).
334
+ - `YDB_USE_IN_MEMORY_PDISKS` (default `0`, values `0`/`1`): store data in RAM only when `1` (fast, non-persistent).
335
+ - `YDB_LOCAL_SURVIVE_RESTART` (default `0`, values `0`/`1`): control persistence across restarts when using a mounted data volume.
336
+ - `YDB_DEFAULT_LOG_LEVEL`, `YDB_FEATURE_FLAGS`, `YDB_ENABLE_COLUMN_TABLES`, `YDB_KAFKA_PROXY_PORT`, `POSTGRES_USER`, `POSTGRES_PASSWORD` – passed through to YDB as in the official `local-ydb` image.
337
+
338
+ - ydb-qdrant:
339
+ - `PORT` (default `8080`): HTTP port inside the container.
340
+ - `LOG_LEVEL` (default `info`).
341
+ - `VECTOR_INDEX_BUILD_ENABLED`.
342
+ - `YDB_QDRANT_COLLECTION_STORAGE_MODE` / `YDB_QDRANT_TABLE_LAYOUT` (`multi_table` or `one_table`).
343
+ - `YDB_QDRANT_GLOBAL_POINTS_AUTOMIGRATE`.
344
+
345
+ > Note: In the `ydb-qdrant-local` image, `YDB_ENDPOINT` is unconditionally set to `grpc://localhost:<YDB_LOCAL_GRPC_PORT>` by the entrypoint — any user-provided value is ignored. Use the standalone `ydb-qdrant` image if you need to connect to an external YDB.
346
+
347
+ #### Apple Silicon (Mac) notes
348
+
349
+ The `ydb-qdrant-local` image is built on top of the `local-ydb` Docker image, which is x86_64/amd64-only. On Apple Silicon (M1/M2/M3) you need to run it under x86_64/amd64 emulation:
350
+
351
+ - Enable Rosetta (x86_64/amd64 emulation) in your Docker backend:
352
+ - Docker Desktop: enable Rosetta to run x86_64/amd64 containers.
353
+ - Or use Colima as in the YDB docs:
354
+ - `colima start --arch aarch64 --vm-type=vz --vz-rosetta`
355
+ - When running the container, force the amd64 platform explicitly:
356
+
357
+ ```bash
358
+ docker run --platform linux/amd64 -d --name ydb-qdrant-local \
359
+ -p 8080:8080 -p 8765:8765 \
360
+ ghcr.io/astandrik/ydb-qdrant-local:latest
361
+ ```
362
+
363
+ This keeps behavior aligned with the official YDB `local-ydb` image recommendations for macOS/Apple Silicon.
364
+
314
365
  #### Docker Compose
315
366
 
316
367
  Example `docker-compose.yml` (can be used instead of raw `docker run`):
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ydb-qdrant",
3
- "version": "4.2.0",
3
+ "version": "4.3.1",
4
4
  "main": "dist/package/api.js",
5
5
  "types": "dist/package/api.d.ts",
6
6
  "exports": {