Distributed (Remote) Mode

Production‑ready deployment of Compozy with external Temporal and Redis.

Distributed ("remote") mode connects Compozy to external infrastructure for durability, scale, and security.

Comparison with Standalone

AspectDistributedStandalone
Use caseProduction, staging, shared QALocal dev, CI, demos
TemporalExternal cluster (mode: remote)Embedded server (mode: standalone)
CacheExternal Redis (redis.mode: distributed)Embedded compatible server (redis.mode: standalone)
AvailabilityMulti‑node, HASingle process
compozy.yaml
mode: distributed

temporal:
  mode: remote
  host_port: temporal.prod.internal:7233
  namespace: compozy-prod

redis:
  mode: distributed
  distributed:
    addr: redis.prod.internal:6379
    password: ${REDIS_PASSWORD}
    tls:
      enabled: true

Migration from Standalone

Follow the migration guide to plan, switch configuration, and validate.

See Also