---
title: "Deploy Qdrant"
description: "Qdrant vector database with API key, persistent volume and Web UI"
category: "AI/ML"
url: https://railway.com/deploy/qdrant-3
---

# Deploy Qdrant

Qdrant vector database with API key, persistent volume and Web UI

**[Deploy Qdrant on Railway](https://railway.com/template/qdrant-3)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/qdrant-3/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** AI/ML

## Template content

### Qdrant https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/qdrant.png

- **Source:** https://github.com/aalfath/qdrant-railway-template
- **Health check:** /readyz
- **Public domain:** Yes

## Documentation

# Deploy and Host Qdrant on Railway

Qdrant is an open-source vector database and similarity search engine written in Rust. It stores embeddings with JSON payloads and finds the nearest neighbours fast, with filtering, hybrid dense and sparse search, and quantization. Developers use it as the retrieval layer for RAG, semantic search and recommendations, through a REST or gRPC API.

## About Hosting Qdrant

Hosting Qdrant means running one stateful server that keeps its collections on disk, so the data directory needs persistent storage that survives restarts and redeploys. The HTTP API and its built-in Web UI must be protected with an API key before they are exposed to the internet, and the server needs enough memory for the vectors you load. This template builds the official Qdrant image (pinned by version and digest) from a GitHub repo, puts storage and snapshots on a Railway volume, generates a 48-character API key, serves the REST API and Web UI on a public HTTPS domain, and checks `/readyz` before traffic switches over.

## Common Use Cases

* Retrieval-augmented generation (RAG): store document embeddings and fetch relevant context for an LLM
* Semantic and hybrid search over products, documentation or support tickets
* Recommendations, deduplication and similarity matching on text, image or audio embeddings

## Dependencies for Qdrant Hosting

* Qdrant v1.20.1, the official `qdrant/qdrant` image
* A Railway volume for collections and snapshots

### Deployment Dependencies

* Qdrant documentation: https://qdrant.tech/documentation/
* Qdrant releases: https://github.com/qdrant/qdrant/releases
* Template source and changelog: https://github.com/aalfath/qdrant-railway-template

### Implementation Details

* The API key is in the service variable `QDRANT__SERVICE__API_KEY`. Send it as the `api-key` header (or `Authorization: Bearer`) on every request. Open `https://YOUR-DOMAIN/dashboard` and paste the key to use the Web UI.
* Other Railway services connect over the private network: `QDRANT_URL=http://${{Qdrant.RAILWAY_PRIVATE_DOMAIN}}:6333` and `QDRANT_API_KEY=${{Qdrant.QDRANT__SERVICE__API_KEY}}`. gRPC is on port 6334 on the same private host.
* Collections live in `/qdrant/data/storage` and snapshots in `/qdrant/data/snapshots`, both on the volume.
* Any other Qdrant setting can be added as a `QDRANT__SECTION__KEY` variable, for example `QDRANT__SERVICE__READ_ONLY_API_KEY` or `QDRANT__TELEMETRY_DISABLED=true`.
* Updates: a new Qdrant version in the template repo shows up as an "update available" notice in your project. Take a snapshot first, and upgrade one minor version at a time.

## Why Deploy Qdrant on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Qdrant on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

Open this page in a browser: https://railway.com/deploy/qdrant-3
