Troubleshooting

Most issues happen very frequently. There’s a chance we covered the solution in our docs and dedicated FAQ sections:

Product Description
LanceDB OSS FAQ For open source users
LanceDB Cloud FAQ For cloud service users
LanceDB Enterprise FAQ For enterprise users

Getting Technical Support

If you are using LanceDB OSS or LanceDB Cloud, the best place to get help is in our Discord community , under the relevant language channel for Python, TypeScript, or Rust. By asking in the language-specific channel, you’re more likely to get a quick response from someone who knows the answer.

If you are a LanceDB Enterprise user, please contact our support team at support@lancedb.com for dedicated assistance.

General Issues

Slow or Unexpected Query Results

If you have slow queries or unexpected query results, it can be helpful to print the resolved query plan.

LanceDB provides two powerful tools for query analysis and optimization: explain_plan and analyze_plan.

Read the full guide on Query Optimization .

Python’s Multiprocessing Module

Multiprocessing with fork is not supported. You should use spawn instead.

Logging in LanceDB Cloud

To provide more information, especially for LanceDB Cloud related issues, enable debug logging. You can set the LANCEDB_LOG environment variable:

code
export LANCEDB_LOG=debug

You can turn off colors and formatting in the logs by setting

code
export LANCEDB_LOG_STYLE=never