Common Issues

Redis in Standalone Mode

• Connection refused / ECONNRESET: ensure the Compozy process is running; embedded cache shares the process lifecycle
• Snapshot failures: verify redis.standalone.persistence.dir exists and is writable; validate interval format
• Slowdowns during tests: disable snapshots or increase interval

Mode Validation Errors

• Unknown mode: only standalone, distributed (and remote for Temporal) are accepted
• Missing required fields: e.g., redis.distributed.addr must be set when redis.mode=distributed
• Conflicting overrides: remove duplicate fields when switching modes

Temporal Standalone

• Port conflicts on 7233–7236 or UI 8233: change frontend_port/ui_port
• Startup timeout: increase temporal.standalone.start_timeout

See also: Temporal Troubleshooting