Production Deployment
Deploy Mosaic Stack to production environments.
Production Deployment#
This guide covers deploying Mosaic Stack to a production environment using Docker Compose.
Infrastructure Requirements#
- Docker and Docker Compose v2+
- PostgreSQL 17+ with pgvector extension
- Valkey 8 (Redis-compatible queue and cache)
- Minimum 2 CPU cores and 4 GB RAM
- Node.js 24+ (for local development)
Services#
- Gateway (NestJS) — port 14242
- Web (Next.js) — port 3000
- PostgreSQL + pgvector — port 5433
- Valkey — port 6380
- OTEL Collector — ports 4317/4318
- Jaeger UI — port 16686
TLS Configuration#
Terminate TLS at the reverse proxy level (Nginx, Traefik, or Caddy). Automated certificate management via cert-manager or ACME is on the roadmap.