mirror of
https://github.com/stablyai/orca.git
synced 2026-09-24 00:02:24 +00:00
21 lines
1.3 KiB
Markdown
21 lines
1.3 KiB
Markdown
# Relay regional placement
|
|
|
|
Orca selects a Relay region in the Electron main process before requesting a new assignment. The
|
|
director publishes an allowlisted region catalog containing only HTTPS cell subdomains of that
|
|
director; Orca takes three bounded `/health` latency samples per region and caches the stable choice
|
|
for 24 hours. A cached region changes only when the alternative is materially faster.
|
|
|
|
The assignment request sends only `preferredRegion`. It does not send latency, IP address, country,
|
|
pairing data, or credentials. Catalog, probe, and cache failures fall back to an assignment without
|
|
a region preference. A rolled-back director that rejects the new field is retried once without
|
|
only that field while preserving reconnect behavior.
|
|
|
|
The selection measures the desktop network path. Folder workspaces and SSH workspaces share the
|
|
same local broker and do not run probes on remote hosts. The phone continues to connect to the
|
|
exact cell URL in the desktop pairing payload, so its location is not measured independently and
|
|
no mobile protocol update is required.
|
|
|
|
For deterministic local diagnostics, set `ORCA_RELAY_REGION_OVERRIDE` to `us-central1` or
|
|
`asia-east2` before launching Orca. The override is not an end-user setting and is not written to
|
|
the preference cache.
|