Ctrl AI

Cloud Deployment

Deploy Ctrl AI on Vercel with Neon PostgreSQL.

The fastest way to get started is deploying to Vercel with a Neon serverless PostgreSQL database.

Prerequisites

  • A Vercel account
  • A Neon database (free tier available)
  • At least one LLM API key (Gemini, Anthropic, or OpenAI)

Steps

  1. Fork or clone the Ctrl AI repository
  2. Create a Neon project and copy the connection string
  3. Import the project in Vercel
  4. Set environment variables (see Environment Variables)
  5. Deploy

Vercel will automatically build and deploy on every push to your main branch.

Required Environment Variables

At minimum, set:

DATABASE_URL=postgresql://...@neon.tech/ctrlai
AUTH_SECRET=<random-32-byte-hex>
GEMINI_API_KEY=<your-key>

See Environment Variables for the full reference.

Audit

Query audit logs and inference execution traces.

Self-Hosted Deployment

Deploy Ctrl AI on your own infrastructure with Docker.

On this page

PrerequisitesStepsRequired Environment Variables