How to beginner · 3 min read

How to install Qdrant locally

Q: How to install Qdrant locally

Install Qdrant locally by running its Docker container with docker run or by downloading the binary from the official site. Docker is the easiest method, requiring only Docker installed and a single command to start the vector database server.

Quick answer

Install Qdrant locally by running its Docker container with docker run or by downloading the binary from the official site. Docker is the easiest method, requiring only Docker installed and a single command to start the vector database server.

PREREQUISITES

Docker installed (Docker Desktop or Docker Engine)
Basic command line knowledge
Optional: Python 3.8+ for client usage

Setup with Docker

The simplest way to install Qdrant locally is using Docker. This method requires Docker installed on your machine. It runs the Qdrant server in a container, isolating dependencies and simplifying setup.

bash

docker run -p 6333:6333 qdrant/qdrant

output

2026-04-27T12:00:00.000 INFO Starting Qdrant v1.2.0
2026-04-27T12:00:00.100 INFO Listening on 0.0.0.0:6333

Step by step usage example

After starting Qdrant with Docker, you can interact with it via HTTP API or client libraries. Here is a Python example using the official qdrant-client to create a collection and insert vectors.

python

import os
from qdrant_client import QdrantClient

# Connect to local Qdrant server
client = QdrantClient(host="localhost", port=6333)

# Create a collection named 'test_collection'
client.recreate_collection(collection_name="test_collection", vector_size=4)

# Insert sample vectors
vectors = [
    ([0.1, 0.2, 0.3, 0.4], 1),
    ([0.5, 0.6, 0.7, 0.8], 2)
]
client.upsert(collection_name="test_collection", points=[
    {"id": id, "vector": vector} for vector, id in vectors
])

# Search for nearest vectors
search_result = client.search(
    collection_name="test_collection",
    query_vector=[0.1, 0.2, 0.3, 0.4],
    limit=1
)
print(search_result)

output

[{'id': 1, 'version': 1, 'score': 1.0, 'payload': None}]

Common variations

You can also install Qdrant by downloading the binary from the official Qdrant site and running it directly without Docker. For development, use the qdrant-client Python package to interact with the server programmatically.

To run Qdrant asynchronously or in Kubernetes, refer to the official docs for deployment manifests and Helm charts.

bash

pip install qdrant-client

output

Collecting qdrant-client
Installing collected packages: qdrant-client
Successfully installed qdrant-client-1.2.0

Troubleshooting

If Docker fails to start Qdrant, ensure Docker daemon is running and ports 6333 are free.
On Windows, enable WSL 2 backend for better Docker compatibility.
If Python client cannot connect, verify the Qdrant server is running on localhost:6333 and firewall rules allow connections.

✅

Key Takeaways

Use Docker to quickly install and run Qdrant locally with a single command.
The official Python client qdrant-client simplifies vector operations and queries.
Direct binary installation is an alternative if Docker is not preferred.
Check Docker and network settings if connection issues arise.
Qdrant supports scalable deployment options beyond local installs.

Verified 2026-04

Verify ↗