Skip to main content
KaireonAI supports three deployment paths depending on your needs:

Local Development

Run on your machine with PostgreSQL and optional Redis. Best for development and evaluation.

Cloud (App Runner)

Deploy to AWS App Runner with Supabase (PostgreSQL) and Upstash (Redis). Fully managed, no servers to maintain.

Kubernetes (Helm)

Self-hosted on any Kubernetes cluster using the provided Helm chart. Full control over infrastructure.

​
Comparison

LocalCloud (App Runner)Kubernetes (Helm)
Best forDevelopment, evaluationSmall-to-medium productionEnterprise production
DatabaseLocal PostgreSQLSupabaseSelf-managed / RDS
CacheLocal Redis (optional)UpstashSelf-managed Redis
ScalingSingle instanceAuto-scaling (App Runner)HPA + custom policies
MonitoringDev toolsCloudWatchPrometheus + Grafana
TLSNot requiredAuto (App Runner)Ingress controller
Setup time5 minutes30 minutes1–2 hours

​
Docker Images

KaireonAI builds two Docker images:
ImagePurpose
kaireon-apiMain Next.js application (UI + API routes)
kaireon-workerBackground job processing (pipelines, model retraining)
You push images to Amazon ECR and tag them with the git SHA plus latest: 
docker build -t kaireon-api .
docker tag kaireon-api:latest 422500312304.dkr.ecr.us-east-1.amazonaws.com/kaireon-api:$(git rev-parse --short HEAD)
docker push 422500312304.dkr.ecr.us-east-1.amazonaws.com/kaireon-api:$(git rev-parse --short HEAD)

​
Environment Variables

All deployment methods use the same environment variables:
VariableRequiredDescription
DATABASE_URLYesPostgreSQL connection string
REDIS_URLNoRedis connection string (enrichment cache, rate limiting)
NEXTAUTH_SECRETYesRandom secret for session encryption
NEXTAUTH_URLYes (prod)Public URL of the application
GOOGLE_CLIENT_IDNoGoogle OAuth client ID (for SSO)
GOOGLE_CLIENT_SECRETNoGoogle OAuth client secret
API_KEY_PEPPERNoHMAC pepper for API key hashing

​
Next Steps

Local Development

Get started with a local PostgreSQL and Redis setup.

Cloud Deployment

Deploy to AWS App Runner with Supabase and Upstash.