Skip to main content

Production Deployment

Production deployment guide for Synap Data Pod

Prerequisites​

  • ✅ Managed PostgreSQL (TimescaleDB + pgvector)
  • ✅ Cloudflare R2 (or S3-compatible storage)
  • ✅ Ory Kratos + Hydra instances
  • ✅ Inngest (cloud or self-hosted)
  • ✅ Domain name and SSL certificate

Environment Configuration​

Database​

DATABASE_URL=postgresql://user:password@host:5432/synap

Requirements:

  • PostgreSQL 16+
  • TimescaleDB extension
  • pgvector extension
  • Row-Level Security enabled

Storage​

STORAGE_PROVIDER=r2
R2_ACCOUNT_ID=your_account_id
R2_ACCESS_KEY_ID=your_access_key
R2_SECRET_ACCESS_KEY=your_secret_key
R2_BUCKET_NAME=synap-storage
R2_PUBLIC_URL=https://pub-xxx.r2.dev

Authentication​

KRATOS_PUBLIC_URL=https://kratos.yourdomain.com
KRATOS_ADMIN_URL=https://kratos-admin.yourdomain.com
HYDRA_PUBLIC_URL=https://hydra.yourdomain.com
HYDRA_ADMIN_URL=https://hydra-admin.yourdomain.com
ORY_HYDRA_SECRETS_SYSTEM=your-secret-key

AI Services​

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-proj-...

Deployment Steps​

1. Database Setup​

# Connect to managed PostgreSQL
# Enable extensions
CREATE EXTENSION IF NOT EXISTS timescaledb;
CREATE EXTENSION IF NOT EXISTS vector;

# Run migrations
pnpm --filter database db:init

2. Storage Setup​

# Create R2 bucket
# Configure CORS
# Set up public URL (if needed)

3. Deploy API​

# Build
pnpm build

# Deploy to your platform (Vercel, Railway, etc.)
# Set environment variables
# Start API server

4. Configure Inngest​

# Set Inngest credentials
INNGEST_EVENT_KEY=your-key
INNGEST_SIGNING_KEY=your-signing-key

Security Checklist​

  • Environment variables secured (not in code)
  • CORS configured correctly
  • Rate limiting enabled
  • SSL/TLS certificates valid
  • Database backups configured
  • Monitoring and alerting set up
  • Log aggregation configured

Monitoring​

Health Checks​

# API health
curl https://api.yourdomain.com/health

# Database health
# Check connection pool
# Monitor query performance

Metrics​

  • Event processing rate
  • API response times
  • Database query performance
  • Storage usage
  • Error rates

Next: See Database Setup for database setup details.