Skip to content

docs(staging): de-Fly the staging host guidance #516

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
BigSimmo merged 3 commits into from
Jul 12, 2026
Merged

docs(staging): de-Fly the staging host guidance #516

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
307893e
docs(staging): de-Fly the staging host guidance
BigSimmo Jul 12, 2026
df72ab7
fix: apply CodeRabbit auto-fixes
coderabbitai[bot] Jul 12, 2026
4d39fe8
Merge branch 'main' into claude/de-fly-staging-doc
BigSimmo Jul 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 3 additions & 6 deletions docs/deployment-architecture.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,12 +35,9 @@ Run the Next.js app as a **single long-lived container** (Node 24, image built
from `Dockerfile`) on a managed container host **in Sydney, co-located with
the Supabase project's ap-southeast-2 region**.

Recommended host: **Fly.io (`syd` region)**, because it runs plain OCI images
with per-app secrets, health checks, and rollback to previous releases, and it
has a Sydney region. Google Cloud Run (`australia-southeast2`) is an equivalent
alternative if a GCP account is preferred; the image is host-agnostic either
way. Railway is _not_ suitable today (no Sydney region — cross-region RPC
latency would multiply across the per-answer fan-out).
Recommended host: any OCI-image host. Production runs on **Railway**; Google
Comment thread
BigSimmo marked this conversation as resolved.
Cloud Run (`australia-southeast2`) is a Sydney-region alternative if lower
answer latency matters. The image is host-agnostic.

### Why a long-lived container and not serverless (Vercel et al.)

Expand Down
8 changes: 4 additions & 4 deletions docs/staging-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,9 @@ those vars are unset.

## B. Staging app host (compute tier)

Recommended host: **Fly.io `syd`** (Sydney region; no MCP available here, so
this is an operator step). Google Cloud Run `australia-southeast2` is the
equivalent. Railway is unsuitable — no Sydney region.
Recommended host: any OCI-image host. Production runs on **Railway**; Google
Comment thread
BigSimmo marked this conversation as resolved.
Cloud Run `australia-southeast2` is a Sydney-region alternative if lower
answer latency matters. No MCP is available here, so this is an operator step.
Comment thread
BigSimmo marked this conversation as resolved.
Comment thread
BigSimmo marked this conversation as resolved.

1. **Build the image** from the committed `Dockerfile`, passing the _staging_
publishable key (it inlines into the client bundle):
Expand Down Expand Up @@ -110,6 +110,6 @@ equivalent. Railway is unsuitable — no Sydney region.
## What is operator-only (cannot be scripted here)

- Creating the Supabase project (billable) and its DB password.
- Opening the Fly.io/host account and setting the runtime secrets.
- Opening the host account (e.g. Railway) and setting the runtime secrets.
- Any change to the **production** project's settings (e.g. auth
percentage-based connection allocation — see `docs/capacity-review.md` §3).
Loading