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

← Operating Neon Law Navigator

Environment Matrix

Chapter 5 of 7 · Section 27 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

Workflow host and routing switches

SwitchWhat the operator controls
NAVIGATOR_WORKFLOW_ENGINESelects the worker engine. dbos starts the DBOS worker alongside Restate.
NAVIGATOR_DBOS_ENABLEDHosts the DBOS executor in web. Requires a separate DBOS database login.
NAVIGATOR_DBOS_ARCHIVES_ENABLEDSelects DBOS for the archive schedule.
NAVIGATOR_DBOS_BILLING_CANARY_ENABLEDRegisters the weekly billing canary in the enabled DBOS host.
NAVIGATOR_DBOS_BILLING_DIGEST_ENABLEDRuns the billing digest through DBOS.
NAVIGATOR_DBOS_DEADLINE_MIRROR_ENABLEDRegisters the DBOS deadline mirror in web.
NAVIGATOR_DBOS_DRI_DIGEST_ENABLEDMoves the DRI digest schedule to DBOS.
NAVIGATOR_DBOS_EMAIL_SUMMARY_ENABLEDSelects DBOS for the durable email summary workflow.
NAVIGATOR_DBOS_FINANCE_AGGREGATE_ENABLEDRoutes finance aggregate work to the DBOS worker.
NAVIGATOR_DBOS_GENERAL_NAG_ENABLEDMoves the General Nag schedule to DBOS.
NAVIGATOR_DBOS_INBOUND_MESSAGE_ALERT_ENABLEDSelects DBOS for inbound message alerts.
NAVIGATOR_DBOS_NIGHTLY_PROJECT_UPDATE_ENABLEDSelects DBOS for nightly project updates.
NAVIGATOR_DBOS_NOTATION_ENABLEDRoutes notation work to the DBOS worker.
NAVIGATOR_DBOS_NOTATION_RESET_ENABLEDMoves the notation reset schedule to DBOS.
NAVIGATOR_DBOS_PROJECT_RECOVERY_ENABLEDRegisters project recovery in web.
NAVIGATOR_DBOS_PROJECT_SLACK_ENABLEDSelects DBOS for Project Slack work. Requires the Slack bot.
NAVIGATOR_DBOS_PURCHASE_ACTIVATION_ENABLEDRegisters purchase activation in web.
NAVIGATOR_DBOS_RECONCILE_INVOICES_ENABLEDSelects DBOS for invoice reconciliation.
NAVIGATOR_DBOS_RETENTION_PURGE_ENABLEDRegisters the retention purge in web. Requires Firm authority config.
NAVIGATOR_DBOS_SANDBOX_CREDIT_RESET_ENABLEDRoutes the sandbox credit reset trigger to DBOS ingress.
NAVIGATOR_DBOS_SENT_EMAIL_EXPORT_ENABLEDRegisters the sent email export in web.
NAVIGATOR_DBOS_SOCIAL_PUBLISHER_ENABLEDRegisters the publisher in the DBOS worker.
NAVIGATOR_DBOS_SOCIAL_PUBLISH_RECONCILER_ENABLEDRegisters the reconciler. Enable the publisher first.
NAVIGATOR_DBOS_SOURCE_IMPORT_ENABLEDRegisters source import in web.

DBOS switches opt in with true and default off. Use false to turn them off. Set the executor or worker selector and the workflow switch together with the credentials its host needs.

See the DBOS runbook for schedule ownership, prerequisites, and rollback.

Presenter notes

A trigger and an executor can read the same switch in different processes. Compare their rendered settings before rolling a workflow over. Verify that one scheduler owns each job and inspect the next expected run in that engine. For a rollback, follow the workflow's runbook so the old scheduler resumes without a duplicate run.

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 6