Process exits: SBX_DATABASE_URL, SBX_VAULT_KEYS and SBX_RUNTIME_MASTER_KEY are required |
Export all three before serve, worker or migrate. |
GET /readyz returns 503 |
The control plane cannot read PostgreSQL; check SBX_DATABASE_URL. |
| Cannot sign in after registering |
Email verification is required. Without SBX_RESEND_API_KEY the link is in $SBX_DATA_DIR/mail/*.json. Tokens expire after 24 hours. |
429 rate_limited on login |
10 failures per email in 15 minutes. Wait and retry. |
csrf_failed in the Console |
The browser origin is not in SBX_ALLOWED_ORIGINS, or the CSRF token is missing. Set the public URL and origins to the Console address. |
validation_failed mentioning Idempotency-Key |
Every mutation needs the header. The SDK and CLI add it. |
Connection stays unverified |
Validation is a background Job; make sure workers run (serve runs them). reauth_required means the provider rejected the credential: replace it. |
Turn waits with connection_required or credential_invalid |
Add or replace the Modal, GitHub or OpenCode Zen Connection. |
Turn waits with waiting_capacity |
Connection capacity is in use; the Turn continues when a slot frees. |
executor_unavailable on Files, Terminal or Services |
No live executor. Reads never wake compute; activate it from the Session. |
Turn ended outcome_unknown |
SBX could not prove the result. Inspect the Worktree, then acknowledge the Turn before retrying. See Sessions and Turns. |
Delivery blocked with remote_head_changed |
The remote branch holds another head. Reconcile with a refresh; SBX never force-pushes. |
Merge fails with gate_blocked |
A required result is missing, stale or for a different subject_digest, checks are not green, or the head moved. Read the reasons in the response. |
409 connection_in_use on disconnect |
Live leases or Executions use the Connection. Release them first. |
| Preview grant fails |
No preview origin is configured; preview is not available. |
invalid_cursor on events |
The cursor is ahead of the journal or after and Last-Event-ID disagree. Fetch a fresh snapshot and resume from its watermark. |
