Deployment

Production deployment

Deployment

Production deployment considerations for Grayscale OS v1.0.


Deployment Models

ModelAudienceDescription
Grayscale CloudMost customersManaged SaaS (commercial)
Dedicated CloudEnterpriseIsolated tenant / VPC
Self-Hosted EvaluationDevelopersLocal Docker development only today
Enterprise On-PremiseBoards, PE, regulatedContractual — contact sales

Self-hosted production deployment guides will expand as Enterprise packages mature. Contact sales@projectgrayscale.com for dedicated deployment.


Local Development Stack

docker compose up -d    # PostgreSQL + Redis
pnpm db:push            # Apply schema
pnpm dev                # Web :3000 + API :4000

Environment Variables

Copy .env.example to .env. Key variables:

DATABASE_URL=postgresql://...
REDIS_URL=redis://...
JWT_SECRET=<strong-secret>
EXECUTIVES_ENABLED=false
AUTONOMOUS_EXECUTION_ENABLED=false

Never commit .env or secrets to version control.


Production Checklist (When Available)

  • Strong JWT_SECRET and rotation policy
  • TLS termination at load balancer
  • PostgreSQL backups and point-in-time recovery
  • Redis persistence configuration
  • EXECUTIVES_ENABLED only after certification
  • Policy Engine rules reviewed and published
  • Integration sandbox enabled for new connectors
  • Audit log retention policy configured
  • SSO (Enterprise) integrated via IdP

Infrastructure Requirements (Indicative)

ComponentMinimumRecommended
API instances23+ (HA)
PostgreSQL16+Managed RDS / Cloud SQL
Redis7+Managed ElastiCache / Memorystore
WebStatic + SSRCDN + Next.js server

Exact sizing depends on organization count and event volume.


Database Migrations

pnpm db:push      # Development
# Production: use approved migration pipeline (Prisma migrate deploy)

Schema changes require Bedrock architecture review — no breaking changes to certified Foundation.


Monitoring

Mission Control exposes platform health endpoints consumed by the founder workspace. Enterprise deployments add:

  • Security observatory
  • Integration health dashboard
  • Event store lag monitoring

Related