krzysztof/landing_page
1
0
Fork 0
mirror of https://github.com/qdrant/landing_page.git synced 2026-10-07 20:08:32 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add Qdrant setup instruction

Browse Source
This commit is contained in:
Kacper Łukawski
2025-12-15 14:47:11 +01:00
parent d0e5354a69
commit c2bff7fd80
1 changed files with 57 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
qdrant-landing/content/course/multi-vector-search/module-0/qdrant-setup.md
+57 -28
View File
@@ -14,51 +14,80 @@ Multi-vector search requires specific collection configurations that differ from
---
<div class="video">
<iframe
src="https://www.youtube.com/embed/dQw4w9WgXcQ"
frameborder="0"
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
referrerpolicy="strict-origin-when-cross-origin"
allowfullscreen>
</iframe>
</div>
## Qdrant Cloud Setup (Recommended)
---
Qdrant Cloud is the fastest way to get started with multi-vector search. It provides a fully managed, production-ready vector database with automatic backups, high availability, and secure TLS connections. Both Qdrant Cloud and the open-source version provide the same feature set - Cloud simply handles the infrastructure for you.
## Qdrant Cloud Setup
### Create Your Cluster
<!-- TODO: Add instructions for setting up Qdrant Cloud account -->
<!-- TODO: Include screenshot of Cloud dashboard -->
<!-- TODO: Add cluster creation steps -->
1. Sign up at [cloud.qdrant.io](https://cloud.qdrant.io/signup) using your email, Google, or GitHub account.
2. Navigate to **Clusters** → **Create a Free Cluster**. The Free Tier provides sufficient resources for this course.
![Create cluster](/docs/gettingstarted/gui-quickstart/create-cluster.png)
3. Select a region closest to your location or application.
4. Once your cluster is ready, copy the API key from the cluster dashboard and store it securely. You can generate additional keys later from the **API Keys** section.
![Get API key](/docs/gettingstarted/gui-quickstart/api-key.png)
### Access the Web UI
Click **Cluster UI** in the top-right corner of your cluster page to open the dashboard.
![Access dashboard](/docs/gettingstarted/gui-quickstart/access-dashboard.png)
The Web UI provides several useful tools:
- **Console**: Test REST API calls directly in your browser
- **Collections**: Manage all your collections and their configurations
- **Tutorial**: Interactive walkthrough with sample data
### Save Your Credentials
Store your cluster URL and API key for use in upcoming lessons. Create an `.env` file in your working directory:
```env
QDRANT_URL=https://YOUR-CLUSTER.cloud.qdrant.io:6333
QDRANT_API_KEY=YOUR_API_KEY
```
Replace `YOUR-CLUSTER` with your actual cluster URL from the dashboard, and `YOUR_API_KEY` with the API key you copied earlier.
You'll use these credentials in the next lesson when we install and configure the Python client.
## Local Qdrant Installation
<!-- TODO: Add Docker installation instructions -->
Qdrant's open-source version provides the same features as Qdrant Cloud but requires you to manage the infrastructure yourself. This option works well for development, testing, or when you need full control over your deployment.
### Docker Installation (Recommended)
The fastest way to run Qdrant locally is with Docker:
```bash
# TODO: Add Docker command to run Qdrant locally
docker run -p 6333:6333 -p 6334:6334 \
-v $(pwd)/qdrant_storage:/qdrant/storage:z \
qdrant/qdrant
```
<!-- TODO: Add alternative installation methods (pip, binary) -->
This command:
- Exposes port `6333` for the REST API
- Exposes port `6334` for the gRPC API
- Mounts a local directory for persistent storage
## Creating Your First Multi-Vector Collection
Once running, you can access the Web UI at `http://localhost:6333/dashboard` to verify the installation.
<!-- TODO: Explain multi-vector collection requirements -->
<!-- TODO: Add Python code example for creating a collection -->
### Alternative Installation Methods
```python
# TODO: Add example code for creating a multi-vector collection
```
For production deployments or other installation methods, see the [Qdrant Installation Guide](/documentation/guides/installation/).
## Verifying Your Setup
<!-- TODO: Add steps to verify Qdrant is running correctly -->
<!-- TODO: Add simple query example to test connection -->
Open the Qdrant Web UI:
- **Cloud users**: Click **Cluster UI** in the top-right corner of your cluster dashboard
- **Local users**: Navigate to `http://localhost:6333/dashboard`
```python
# TODO: Add verification code
```
If the Web UI loads and you can see the **Collections** tab, your setup is complete. In the next lesson, you'll install the Python dependencies to connect programmatically.
---