From 65469933fe32b56b7623f3500cab3d8ee6180773 Mon Sep 17 00:00:00 2001 From: Haifeng He Date: Tue, 24 Feb 2026 09:41:12 -0800 Subject: [PATCH 1/2] Fix macOS port conflicts in develop.env Ports 4000/5000/4001/5001 can conflict with macOS system services (notably AirPlay Receiver on port 5000 since macOS Monterey 12+). Replace with ports that mirror the internal Temporal/gRPC scheme. Co-Authored-By: Claude Sonnet 4.6 --- develop/docker-compose/develop.env | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/develop/docker-compose/develop.env b/develop/docker-compose/develop.env index 74043ec..c799e8b 100644 --- a/develop/docker-compose/develop.env +++ b/develop/docker-compose/develop.env @@ -1,8 +1,8 @@ # External Ports (exposed via localhost) -TEMPORAL_LEFT_EXTERNAL_PORT=4000 -TEMPORAL_RIGHT_EXTERNAL_PORT=5000 -PROXY_LEFT_EXTERNAL_PORT=4001 -PROXY_RIGHT_EXTERNAL_PORT=5001 +TEMPORAL_LEFT_EXTERNAL_PORT=17233 +TEMPORAL_RIGHT_EXTERNAL_PORT=27233 +PROXY_LEFT_EXTERNAL_PORT=16233 +PROXY_RIGHT_EXTERNAL_PORT=26333 PROXY_LEFT_METRICS_EXTERNAL_PORT=4091 PROXY_RIGHT_METRICS_EXTERNAL_PORT=5091 PROMETHEUS_EXTERNAL_PORT=9090 From 549edbbf6ec348dabf0543b9abab5aba80b93a6a Mon Sep 17 00:00:00 2001 From: Haifeng He Date: Tue, 24 Feb 2026 10:25:24 -0800 Subject: [PATCH 2/2] update --- develop/README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/develop/README.md b/develop/README.md index 194f2dc..e7d8b2a 100644 --- a/develop/README.md +++ b/develop/README.md @@ -18,6 +18,25 @@ 2. Done! Run tests against these services. The default ports are specified in an [environment file](docker-compose/develop.env) 3. To stop the development environment: `make stop-dependencies` +### Example Commands + +The two Temporal clusters are exposed on `localhost:17233` (left) and `localhost:27233` (right). + +```bash +# Describe cluster +temporal operator cluster describe --address localhost:17233 +temporal operator cluster describe --address localhost:27233 + +# List namespaces +temporal operator namespace list --address localhost:17233 + +# List workflows in the default namespace +temporal workflow list --address localhost:17233 --namespace default + +# Describe a namespace +temporal operator namespace describe default --address localhost:17233 +``` + ### Logs - To view container logs, run `docker logs `. For example `docker logs docker-compose-smoke-test-1`.