Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cognee.ai/llms.txt

Use this file to discover all available pages before exploring further.

Make sure that ENABLE_BACKEND_ACCESS_CONTROL in your .env file is NOT set to False. Multi-user mode is enabled by default, therefore ENABLE_BACKEND_ACCESS_CONTROL=True by default.
The LanceDB adapter is one of Cognee’s core vector adapters, along with PGVector.

​
Installation

LanceDB is part of Cognee’s core dependencies, so no extra installation steps are required.

​
Setup and Usage

Since LanceDB is a file-based database, and its handler is registered in Cognee by default, all that needs to be set is the information about the provider, and to let Cognee know which handler you are using: 
VECTOR_DB_PROVIDER="lancedb"
VECTOR_DATASET_DATABASE_HANDLER="lancedb"
LanceDB vector files are stored by default in the .cognee_system folder (within the Cognee package), with each dataset assigned its own persistent vector database file.

​
Schema Migrations

When you upgrade Cognee and the LanceDB payload schema changes, run_startup_migrations() migrates existing collections to the new schema. In multi-user mode this runs for every dataset database automatically. Migration behavior for existing rows:
  • If all existing rows can be backfilled to the new schema (including required fields that have defaults or types that admit a safe fallback), the migration completes and the collection is updated in place.
  • If any existing row cannot be backfilled — for example because a newly added field is required and has no default — the migration aborts with a RuntimeError and leaves the collection unchanged.
The error message names the collection and how many rows failed, along with sample validation errors. To resolve it:
  1. Add an explicit default value to the new required field in your DataPoint model, or
  2. Make the new field Optional[YourType] (which defaults to None).
Then re-run run_startup_migrations().
If a dataset database migration fails, Cognee logs the error and continues migrating the remaining dataset databases. The failed dataset is left in its original state and can be retried after you fix the schema.

Vector Stores

Details About Cognee’s Vector Stores

Multi-User Overview

More Details About Multi-User Mode