Skip to content

fix(docker): increase Temporal startup timeout for Windows/WSL2#341

Open
Alexi5000 wants to merge 1 commit into
KeygraphHQ:mainfrom
Alexi5000:pr/fix-temporal-timeout
Open

fix(docker): increase Temporal startup timeout for Windows/WSL2#341
Alexi5000 wants to merge 1 commit into
KeygraphHQ:mainfrom
Alexi5000:pr/fix-temporal-timeout

Conversation

@Alexi5000
Copy link
Copy Markdown

Summary

Fixes #331

Root cause

The fixed 60s poll budget (30 iterations x 2s) is exhausted on WSL2 where NTFS-backed Docker volumes add 20-40s to Temporal's SQLite journal init. The CLI poll loop also races Docker's own healthcheck rather than coordinating with it.

Changes

  • Replace fixed-iteration loop with deadline-based timeout (default 120s)
  • Add isContainerHealthy() that checks Docker's healthcheck status
  • Accept SHANNON_TEMPORAL_TIMEOUT_MS env var for custom timeout
  • Increase poll interval from 2s to 3s
  • Bump start_period in both compose files from 30s to 60s
  • Actionable error message on timeout

Test plan

  • Verify on Linux (fast path)
  • Verify on Windows/WSL2 (slow path: 40-90s startup)
  • Verify SHANNON_TEMPORAL_TIMEOUT_MS=30000 causes timeout on slow hosts

Fixes KeygraphHQ#331

Replace fixed 60s poll budget with deadline-based timeout (default 120s,
configurable via SHANNON_TEMPORAL_TIMEOUT_MS). Add Docker healthcheck
coordination. Bump compose start_period from 30s to 60s.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug][Windows/Docker Desktop] "Timeout waiting for Temporal" - gRPC health check fails on Windows/WSL2

1 participant