Neon LawCall +1 510 800 2090
  • Navigator
  • Notations
  • Legal Aid
  • Sign in

← Operating Neon Law Navigator

Environment Matrix

Chapter 5 of 7 · Section 37 of 54

Sections

1. Intro

  • 1. Deploy your own
  • 2. Agenda

2. Prepare Google Cloud

  • 3. Bring your own project
  • 4. Dry-run first
  • 5. Private assets and domain restricted sharing
  • 6. The Navigator deployment matrix
  • 7. The `/app` mount and HTTP route ownership
  • 8. `neon` — the whole brand seam
  • 9. Live rollout checkpoint
  • 10. Set one site to one version

3. Provision the Infrastructure

  • 11. The APIs that light up
  • 12. Network and storage buckets
  • 13. How a matter's pages reach a client
  • 14. A document's bytes and authorization are separate
  • 15. A private image registry
  • 16. The cluster comes up
  • 17. What setup owns — and what follows it

4. Operate Forgejo beside Navigator

  • 18. Deploy the forge before switching repositories
  • 19. Separate people, Git transport, and machine access
  • 20. Require the gate and protected-main policy
  • 21. Bind the workflow to one Project and one commit
  • 22. Notify failures even when the manifest is broken
  • 23. Restore the repository before cutting over

5. Environment Matrix

  • 24. Three operating modes, two deployment profiles
  • 25. The deployment that says its matters are sample
  • 26. Deployment and release switches
  • 27. Workflow host and routing switches
  • 28. Capability and storage switches
  • 29. Configuration precedence: the first source wins
  • 30. Local dev controls: inputs read by `hudson dev`
  • 31. Local runtime: what `.devx/env` generates
  • 32. The store: SurrealDB
  • 33. Where SurrealDB authorization lives
  • 34. Deployed runtime: core web and worker wiring
  • 35. Deployed runtime: identity and access
  • 36. Deployed runtime: email, signatures, and billing
  • 37. Deployed runtime: repositories, content, AI, and scheduled work
  • 38. Provision and ship: variables read by the operator CLI
  • 39. Ancillary operations and opt-in test controls
  • 40. When sample data appears

6. Configure the Trust Boundaries

  • 41. Secrets: the invariants that gate the boot
  • 42. Secret access, encryption, and audit
  • 43. Sign-in: bring an OIDC provider; passwords live there, not here
  • 44. Role rings: who can do what
  • 45. Provider setup and parity across deployment rows
  • 46. The external surface — every third party, in one place
  • 47. The two service deployments
  • 48. Security architecture

7. Ship the Instance

  • 49. Ship and verify
  • 50. Point your domain at the instance (optional)
  • 51. Drive it from the CLI
  • 52. Make it yours — white-label under your own brand
  • 53. First-ship lessons
  • 54. Canonical references

Deployed runtime: repositories, content, AI, and scheduled work

CapabilityEnvironment variables
Mounted Git writerNAVIGATOR_GIT_REPO_ROOT
Forge coordinate, both requiredNAVIGATOR_GIT_HOST (default github.com), NAVIGATOR_GITHUB_ORG (no default)
GitHub App identityNAVIGATOR_GITHUB_APP_ID
GitHub App installationNAVIGATOR_GITHUB_INSTALLATION_ID
GitHub App proofNAVIGATOR_GITHUB_APP_PRIVATE_KEY
GitHub token fallbackNAVIGATOR_GITHUB_TOKEN (or GITHUB_TOKEN)
GitHub endpointNAVIGATOR_GITHUB_API_BASE
GitHub webhook receiverNAVIGATOR_GITHUB_WEBHOOK_SECRET, NAVIGATOR_GITHUB_CANONICAL_REPOSITORY
Receiver identity and Restate submitNAVIGATOR_GITHUB_APP_LOGIN, RESTATE_INGRESS_URL, RESTATE_AUTH_TOKEN
GitHub concurrency capNAVIGATOR_GITHUB_MAX_CONCURRENT
GitHub revision capNAVIGATOR_GITHUB_MAX_REVISE_ROUNDS
GitHub daily token capNAVIGATOR_GITHUB_MAX_DAILY_TOKENS
DevX Slack worker (in workflows-service)SLACK_WEBHOOK_URL
Content rootsNAVIGATOR_PUBLIC_DIR, NAVIGATOR_WORKSHOPS_DIR
CLI login fileNAVIGATOR_CREDENTIALS_FILE, NAVIGATOR_CONFIG_DIR
Harness worktree/cacheNAVIGATOR_WORKTREE_PATH, NAVIGATOR_CHROME_CACHE_DIR
Vertex coordinatesNAVIGATOR_GCP_PROJECT_ID, NAVIGATOR_GCP_LOCATION, GOOGLE_METADATA_URL
Contract reviewerNAVIGATOR_CONTRACT_REVIEW_MODEL plus the same GCP project, location, and metadata variables
On-chain attestationNAVIGATOR_ONCHAIN_BACKEND
Billing exportBILLING_EXPORT_TABLE, BIGQUERY_PROJECT
Billing noticesBILLING_CANARY_NOTIFY_EMAIL
Billing digestBILLING_DIGEST_NOTIFY_EMAIL, BILLING_DIGEST_WINDOW_DAYS
Meta (Facebook, Instagram) appNAVIGATOR_META_APP_ID, NAVIGATOR_META_APP_SECRET
Threads appNAVIGATOR_THREADS_APP_ID, NAVIGATOR_THREADS_APP_SECRET
TikTok business appNAVIGATOR_TIKTOK_BUSINESS_APP_ID, NAVIGATOR_TIKTOK_BUSINESS_APP_SECRET
YouTube clientNAVIGATOR_YOUTUBE_CLIENT_ID, NAVIGATOR_YOUTUBE_CLIENT_SECRET
LinkedIn clientNAVIGATOR_LINKEDIN_CLIENT_ID, NAVIGATOR_LINKEDIN_CLIENT_SECRET
X clientNAVIGATOR_X_CLIENT_ID, NAVIGATOR_X_CLIENT_SECRET

Presenter notes

Matter creation must have a real Git writer even if the higher-level forge is local. The content variables only relocate the read-only files baked into the image. Navigator MCP uses NullRouter without the GCP project; contract review uses StubContractReviewer without the same Vertex coordinates. The on-chain backend defaults to null, recording no transaction. Scheduled cost and billing diagnostics stay disabled when their table or recipient variables are absent.

The GitHub webhook receiver is the exception to that degrade-quietly pattern, and where it runs is deliberate. It is served at POST workflows.<domain>/webhooks/github/{secret} by workflows-service, on its own Axum listener (WORKFLOWS_WEBHOOK_LISTEN, 9082) beside the worker's Restate endpoint; the Envoy sidecar routes /webhooks/github/* to that listener and every other path to the Restate leg. It runs on the workflows host, not on www, because www remains behind the firm's Tailscale tailnet perimeter — and GitHub, an external sender that cannot join a tailnet, can only reach a public host. That split is the rule worth remembering: the tailnet protects the human surface (www, the portal, the workbench), while a machine caller's endpoint stays public and is authenticated by the signature it carries, not by the network it arrives from. GitHub signs each delivery, so the receiver verifies X-Hub-Signature-256 against the raw body — which is why the Envoy leg to it stays HTTP/1.1 end to end and forwards the bytes unaltered.

Startup still requires the webhook secret, canonical repository, GitHub org, and app login, and RESTATE_INGRESS_URL plus RESTATE_AUTH_TOKEN: a receiver that cannot verify a delivery or reach the Restate ingress has no safe reduced mode. It is still one worker process — there is no separate receiver container — but it now owns a second listener port that Envoy fronts, rather than sharing web's. The DevX Slack services DevxIssueTriage and devx-pr fold into workflows-service alongside the legal workflows and the receiver; they alone read SLACK_WEBHOOK_URL and fail closed when Slack is absent so Restate can retry instead of acknowledging a lost engineering notice. Only rows with the explicit NAVIGATOR_GITHUB_AUTOMATION_HOME capability may mount the receiver or bind the GitHub services. Those rows also require positive NAVIGATOR_GITHUB_MAX_CONCURRENT, NAVIGATOR_GITHUB_MAX_REVISE_ROUNDS, and NAVIGATOR_GITHUB_MAX_DAILY_TOKENS values; the singleton devx-guardrails/global object serializes reservations, defers work at the concurrency cap, and pauses new token reservations through the UTC-day reset. Unmarked rows do not bind that object or read these limits.

The receiver watches the canonical source repository and the organization configured for the marked row. A delivery is accepted when it comes from that canonical repository or a repository owned by the configured organization.

View all slidesOpen display
← PreviousNext →
Neon Law
  • X opens in a new tab
  • LinkedIn opens in a new tab
  • YouTube opens in a new tab
  • API
  • Blog
  • Contact
  • Design
  • Glossary
  • Navigator
  • Notations
  • Presentations
  • Privacy
  • Team opens in a new tab
  • Terms
  • Testimonials
  • contact@neonlaw.com
  • +1 510 800 2090
  • California
    1515 20th StreetBakersfield, CA 93301
  • Nevada
    5150 Mae Anne AveSte 405-9002Reno, NV 89523
  • New York
    12 E 49th St18th FloorNew York, NY 10017
  • Washington
    1111 Main StSTE 201EVancouver, WA 98660
  • Justice Technology AssociationMission-Aligned Partner opens in a new tab
  • Proud member of Greater Vancouver ChamberGVC opens in a new tab

Attorney advertisement. Nothing here is legal advice without a signed retainer for an active project. Past results do not guarantee future outcomes.

Everyone deserves access to justice.Made with ❤️ in 🗽.

© 2026 Guieb & Shook PC

Powered by neon-law/navigator opens in a new tab26.11.17-rc.1GitHub stars 5