Oximy Docs

Deployments

Deployment-oriented docs for Oximy surfaces.

Current deployment split

Oximy deployment docs should stay anchored to the repo's real workflows and infrastructure:

  • API and worker services run through Railway-oriented service configuration.
  • Dashboard deployment is Vercel-oriented.
  • Staging and production should stay separate in scripts, environment variables, and documentation.

Existing references

Useful source docs already exist in the repository:

  • docs/deployment/staging.md
  • docs/deployment/staging-handover.md
  • docs/deployment/staging-otel.md
  • docs/ON_PREM_ARCHITECTURE.md
  • docs/ON_PREM_DISTR_RUNBOOK.md

What belongs here

Deployment runbooks should cover:

  • Required environment variables.
  • Database and queue isolation.
  • Release verification.
  • Rollback paths.
  • Observability links and expected smoke checks.

On this page