Deployment

Vercel (Recommended)

Zero-config deployment with serverless functions and edge middleware.

1. Push your code to GitHub
2. Import the repository in vercel.com/new
3. Add environment variables in the Vercel dashboard
4. Deploy

{
  "functions": {
    "src/app/api/chat/route.ts": {
      "maxDuration": 60
    }
  }
}

Railway

Simple deployment with built-in PostgreSQL and Redis.

1. Create a new project at railway.app
2. Add PostgreSQL and Redis services
3. Deploy from GitHub repository
4. Set environment variables using the Railway dashboard

Docker

For self-hosted deployment on any server or cloud provider.

version: "3.8"
services:
  app:
    build: .
    ports:
      - "3000:3000"
    env_file: .env
    depends_on:
      - db
      - redis

  db:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_DB: ragkit
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  pgdata:

docker compose up -d
docker compose exec app npx prisma db push

Production Checklist

• ✓ Set NODE_ENV=production
• ✓ Generate a strong NEXTAUTH_SECRET (min 32 chars)
• ✓ Configure ENCRYPTION_MASTER_KEY for field-level encryption
• ✓ Set up Redis (Upstash or self-hosted) for rate limiting
• ✓ Configure Cloudinary or S3 for file storage
• ✓ Set up Inngest for background job processing
• ✓ Enable SSL/TLS on your database connection
• ✓ Review ALLOWED_ORIGINS and CSP_CONNECT_SRC for security