Overview
This AMI runs Qdrant, the open-source vector database and similarity search engine, on Ubuntu 24.04 LTS. The official Qdrant container image is pinned to Qdrant 1.20.0 (the unprivileged variant, which runs as a normal user) and baked into the AMI, so first start does not depend on a registry. Qdrant is an independent open-source project and Perimattic is not affiliated with it; product names are trademarks of their respective owners.
Why Qdrant?
Qdrant stores vectors (embeddings) with a JSON payload and searches them by similarity, with filtering, for semantic search, recommendations and retrieval-augmented generation. It has REST and gRPC APIs and a web dashboard.
What Perimattic adds
Secure by default: a Qdrant started without an API key answers every request from anyone. At first login this AMI generates a random 24-character API key and a second read-only key on your server and starts Qdrant with both. Setup then checks that anonymous and wrong-key requests are refused, that the key can create a collection, upsert points and search, and that the read-only key can read but not write, before the site is published. There are no default or shared keys in the image.
HTTPS: Apache is configured as a reverse proxy and a free Let's Encrypt certificate is requested for your domain with certbot. The REST API and dashboard are published on https://your-domain ; Qdrant itself listens only on the loopback interface.
What is and is not exposed
REST API: on HTTPS, every call except GET / (version number), /healthz, /livez, /readyz and the dashboard's static files needs the key. The dashboard page loads without a key but shows no data until you enter the key in it.
gRPC (port 6334) is not published to the internet: Apache cannot proxy it, so it listens on 127.0.0.1 only. Use an SSH tunnel for gRPC clients; the same API key applies. Only ports 22, 80 and 443 are open.
Telemetry to Qdrant is switched off.
Data and sizing
Collections are stored in /opt/app/storage and snapshots in /opt/app/snapshots on the instance's root volume (owned by the Qdrant user), so choose the root EBS volume size for your data and take EBS snapshots for backup. Qdrant held about 60 to 90 MB of memory when empty in our tests; real usage grows with your vectors (roughly 4 bytes per dimension per vector, plus index overhead, if kept in memory). A t3.medium (4 GB) is the recommended starting size; size up with your data.
Licence
Qdrant is released under the Apache License 2.0; this AMI runs the unmodified upstream image.
Getting Started Launch the AMI and open ports 22, 80 and 443 in the security group SSH in and answer the setup prompts (domain and admin email) Copy the API key printed at the end of setup Call https://your-domain/collections with the header api-key:
A domain name with an A record pointing at the instance is required, because the API is served over HTTPS. Embeddings are created by your application; Qdrant does not generate them.
This AMI is built and supported by Perimattic.
Book a free setup consultation at https://cal.com/gaurav-pareek-perimattic/marketplace-setup-consultations or email us at aws-support@perimattic.com .
Support Managed and supported by Perimattic, a cloud infrastructure company with 13+ years of experience serving global clients. We offer free setup assistance, custom integrations, infrastructure consulting, and 24/7 support.
Highlights
- Qdrant 1.20.0 (Apache-2.0), pinned and pre-installed: a vector database with REST and gRPC APIs and a web dashboard on your own server.
- Secure first login: a random 24-character API key and a read-only key are generated on your server and checked before the site is published; anonymous requests are refused; HTTPS through Apache and Let's Encrypt.
- Built on patched Ubuntu 24.04 LTS and supported by Perimattic: free setup assistance at aws-support@perimattic.com.
Details
Introducing multi-product solutions
You can now purchase comprehensive solutions tailored to use cases and industries.
Features and programs
Financing for AWS Marketplace purchases
Pricing
- ...
Dimension | Cost/hour |
|---|---|
t3.medium Recommended | $0.03 |
t3.micro | $0.03 |
c3.2xlarge | $0.03 |
c3.4xlarge | $0.03 |
c3.8xlarge | $0.03 |
c3.large | $0.03 |
c3.xlarge | $0.03 |
c4.2xlarge | $0.03 |
c4.4xlarge | $0.03 |
c4.8xlarge | $0.03 |
Vendor refund policy
For any questions or concerns, please contact: Perimattic.com Email: aws-support@perimattic.com
How can we make this page better?
Legal
Vendor terms and conditions
Content disclaimer
Delivery details
64-bit (x86) Amazon Machine Image (AMI)
Amazon Machine Image (AMI)
An AMI is a virtual image that provides the information required to launch an instance. Amazon EC2 (Elastic Compute Cloud) instances are virtual servers on which you can run your applications and workloads, offering varying combinations of CPU, memory, storage, and networking resources. You can launch as many instances from as many different AMIs as you need.
Version release notes
Initial release.
- Application: Qdrant 1.20.0 (container image pinned, baked into the AMI).
- Base: Ubuntu 24.04 LTS, fully patched at build time, built by an automated EC2 Image Builder pipeline.
- TLS: Apache reverse proxy with a Let's Encrypt certificate requested by certbot at first login.
- Credentials are generated on the instance at first login; none are present in the image.
- Qdrant has no accounts: a random API key and a read-only key are generated at first login; setup verifies that anonymous and wrong-key requests are refused, that the key can create a collection, upsert and search, and that the read-only key cannot write, before the site is published.
- Application: Qdrant 1.20.0 (Apache-2.0, unmodified official image, unprivileged variant, pinned). Telemetry is off.
- gRPC (6334) listens on 127.0.0.1 only and is not published; use an SSH tunnel.
Additional details
Usage instructions
-
Launch an Instance
From AWS Marketplace, click Continue to Subscribe and then Continue to Configuration to launch the AMI.
-
Choose the Recommended Instance Type
t3.medium (4 GB of memory) is the recommended starting size. Qdrant itself used about 60 to 90 MB when empty; what it needs depends on your data (roughly 4 bytes per dimension per vector in memory, plus index overhead), so size up for large collections.
-
Configure Security Group
Allow inbound traffic on the following ports:
- 22 (SSH) - terminal access for setup
- 80 (HTTP) - needed to validate your domain for the TLS certificate
- 443 (HTTPS) - access to Qdrant
-
Point a domain at the instance
Create a DNS A record (for example qdrant.example.com) pointing to the instance's public IP before you log in.
-
Connect to the Instance
ssh -i <your-key.pem> ubuntu@<public-ip>
-
First-Login Setup
The first SSH login runs a guided setup:
- Prompts for your domain and admin email and checks the DNS A record
- Generates a random 24-character API key, a read-only key and starts Qdrant with both
- Checks that anonymous and wrong-key requests are refused, that the key can create a collection, upsert and search, and that the read-only key cannot write
- Configures Apache as an HTTPS reverse proxy and requests a Let's Encrypt certificate
- Prints the URL and both keys; they are also stored in /opt/app/access.txt (root only)
If a step fails, fix the problem shown and log in again: the setup resumes where it stopped.
-
Access Qdrant
Call https://<your-domain>/collections with the header 'api-key: <your key>' (view the keys again with: sudo cat /opt/app/access.txt). The dashboard is at https://<your-domain>/dashboard: enter the key there. gRPC (port 6334) is local to the server: reach it through an SSH tunnel.
-
Credentials
Generated on your server, never shared between customers. View them again with:
sudo cat /opt/app/access.txt
-
Manage the Services
cd /opt/app sudo docker compose ps sudo docker compose restart
Collections are in /opt/app/storage and snapshots in /opt/app/snapshots (owned by uid 1000): back up /opt/app or snapshot the volume before upgrades. To rotate a key, edit QDRANT_API_KEY in /opt/app/.env and run: cd /opt/app && sudo docker compose up -d. Do not put the key in a URL query string, because server logs record URLs.
Thank you for subscribing.
Need Support or Customization? Perimattic's team can help with setup issues, custom features and integrations:
Email us: aws-support@perimattic.com WhatsApp: +91-92142 66896 Learn more: <www.perimattic.com >
We offer free setup assistance, custom development and integrations, and infrastructure consulting.
Resources
Support
Vendor support
Support by Perimattic
Perimattic provides 24/7 support for all AWS Marketplace products. Our team has 13+ years of cloud infrastructure expertise serving global clients.
Contact Channels: Email: aws-support@perimattic.com WhatsApp: +91-92142 66896 Website: <www.perimattic.com >
What We Help With: Initial setup and configuration assistance (free) Troubleshooting connectivity, performance, and backup issues Custom development and integrations Infrastructure consulting and architecture review Migration planning from other solutions Automation solutions and scaling guidance
Instance Sizing Guidance: t2.medium or t3.medium: Development environments, small applications m5.large: Production workloads with moderate traffic m5.xlarge: High-traffic production deployments and larger datasets
For workload-specific sizing recommendations, contact our team for a free consultation.
Refunds and Issues: If you experience any issues or need to request a refund, contact us at aws-support@perimattic.com and we will respond promptly.
AWS infrastructure support
AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.