Deployment Guide
Deployment Guide
Section titled “Deployment Guide”This guide covers deploying Querri to production environments.
Docker Deployment
Section titled “Docker Deployment”Build Images
Section titled “Build Images”# Set version variablessource scripts/set-version-env.sh
# Build all servicesdocker compose buildRun Production Stack
Section titled “Run Production Stack”docker compose up -dHealth Checks
Section titled “Health Checks”Verify deployment:
# Frontendcurl http://localhost/
# Backendcurl http://localhost/api/healthz
# Hub servicecurl http://localhost/hub/healthzEnvironment Configuration
Section titled “Environment Configuration”Required environment variables:
Database
Section titled “Database”MONGO_URI=mongodb://mongo:27017DATABASE_NAME=querriAuthentication
Section titled “Authentication”WORKOS_API_KEY=your_keyWORKOS_CLIENT_ID=your_client_idJWT_SECRET=your_secretAI Services
Section titled “AI Services”OPENAI_API_KEY=your_keyStorage
Section titled “Storage”FILE_STORAGE_TYPE=s3AWS_ACCESS_KEY_ID=your_keyAWS_SECRET_ACCESS_KEY=your_secretAWS_S3_BUCKET=querri-filesMonitoring
Section titled “Monitoring”View logs:
# All servicesdocker compose logs -f
# Specific servicedocker compose logs -f web-appdocker compose logs -f server-apiMetrics
Section titled “Metrics”Monitor resource usage:
docker statsScaling
Section titled “Scaling”Horizontal Scaling
Section titled “Horizontal Scaling”Scale services:
# Scale backend APIdocker compose up -d --scale server-api=3
# Scale with load balancer# Update docker-compose.yml with replica configuration