Deployment Overview
Deploy Cortex on your infrastructure.
Cortex can be deployed on various platforms. This guide covers the options and requirements.
Requirements
| Component | Minimum | Recommended |
|---|---|---|
| Node.js | 18+ | 20+ |
| PostgreSQL | 14+ | 16+ (with pgvector) |
| Qdrant | 1.7+ | Latest |
| RAM | 2GB | 4GB+ |
Deployment Options
| Platform | Best For | Complexity |
|---|---|---|
| Render | Quick start, small teams | Low |
| Neon | Serverless PostgreSQL | Low |
| Docker | Self-hosted, full control | Medium |
| Vercel | Serverless Next.js | Medium |
| AWS/GCP | Enterprise, compliance | High |
Environment Variables
# Database (PostgreSQL with pgvector)
DATABASE_URL=postgresql://user:password@localhost:5432/cortex
# Vector DB (Qdrant)
QDRANT_URL=http://localhost:6333
# Authentication
AUTH_SECRET=your-random-secret-here
AUTH_URL=http://localhost:4040
AUTH_GITHUB_ID=your-github-client-id
AUTH_GITHUB_SECRET=your-github-client-secret
# AI/Embeddings
OPENAI_API_KEY=sk-your-openai-key
# App
NEXT_PUBLIC_APP_URL=http://localhost:4040
NODE_ENV=development
Quick Start
# Clone the repository
git clone https://github.com/cortex-labs/cortex.git
cd cortex
# Install dependencies
npm install
# Start development server
npm run dev
Open http://localhost:4040 in your browser.