Skip to content

fix(cli): improve local start diagnostics#5616

Open
jgoux wants to merge 1 commit into
developfrom
fix/issue-3265-local-start
Open

fix(cli): improve local start diagnostics#5616
jgoux wants to merge 1 commit into
developfrom
fix/issue-3265-local-start

Conversation

@jgoux

@jgoux jgoux commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

What changed

This improves local stack startup behavior in the Go CLI path used by the TypeScript legacy wrappers.

When a local API request fails because the configured API port returns a malformed HTTP response, the CLI now adds a targeted hint that another process may be listening on that port. The hint includes the configured port, an lsof command to identify the listener, and the api.port config field to change when the port is intentionally occupied.

Startup also now waits for all started services to pass health checks before seeding storage buckets declared in [storage.buckets]. This keeps bucket creation from appearing to be the failing step when another service, especially edge runtime, has not become healthy yet.

The edge-runtime main service keeps its regular remote module imports. This PR does not change the edge-runtime module graph; it focuses on making local-start failures easier to diagnose and preserving clearer startup ordering.

Why

Issue #3265 has shown two recurring local-start failure patterns: a misleading malformed /storage/v1/bucket response when another process owns the API port, and bucket seeding logs appearing before edge runtime health failures. These changes make the port-conflict case self-diagnosing and ensure storage bucket seeding only runs after the local stack is healthy.

@jgoux jgoux force-pushed the fix/issue-3265-local-start branch 2 times, most recently from da530ca to 3bfcaa3 Compare June 18, 2026 09:49
@jgoux jgoux marked this pull request as ready for review June 18, 2026 10:19
@jgoux jgoux requested a review from a team as a code owner June 18, 2026 10:19
@jgoux jgoux force-pushed the fix/issue-3265-local-start branch 2 times, most recently from b5626fe to ff01bdf Compare June 18, 2026 10:40

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ff01bdf683

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread apps/cli-go/internal/start/start.go
Comment thread apps/cli-go/internal/functions/serve/serve_test.go
@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown

Supabase CLI preview

npx --yes https://pkg.pr.new/supabase/cli/supabase@5beb860297727a98cdcbbe3e965c94cc8718171d

Preview package for commit 5beb860.

@jgoux jgoux force-pushed the fix/issue-3265-local-start branch from ff01bdf to 5beb860 Compare June 18, 2026 10:53
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.

1 participant