Running on a Node server
Production and shared test have run on Oracle Cloud VMs since 23 October 2026.
They use Node 24.13.0, SQLite and R2 through its S3 API. lib/platform adapts
these services to the database and bucket interfaces used by the application.
Settings
Runtime variables are loaded by systemd from /etc/suite/suite.env.
| Variable | Value |
|---|---|
SUITE_DATABASE_PATH | absolute path of the SQLite file; deployed path /var/lib/suite/suite.db |
OIDC_ISSUER | the environment's public HTTPS origin |
R2_ENDPOINT | https://<account id>.r2.cloudflarestorage.com |
R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY | credentials restricted to that environment's buckets |
R2_BUCKET_MEDIA, R2_BUCKET_MEDIA_PUBLIC, R2_BUCKET_AVATAR | bucket names for the environment; the storage-only wrangler.jsonc lists them |
The public origins are https://suite.sabrobotix.com (production) and
https://suite-test.sabrobotix.com (shared test).
Build, migrate, start
npm ci
npm run build
npm run db:migrate:node
npm start
Supply SUITE_DATABASE_PATH in the process environment before migration
and startup. Supply NEXT_PUBLIC_SITE_URL, NEXT_PUBLIC_ENV=prod and
the public feature flags before building. For deployment, use
deploy/node/deploy.sh test|prod in Bash; it sets the build variables and
packages the release for Linux. Internal deployment details are in
docs/oracle-production.md.
The npm scripts work on Windows and macOS without Unix variable assignments.
db:migrate:node applies migrations transactionally and keeps the
d1_migrations ledger inherited from D1. Migrate test before production.
What stays on Cloudflare
DNS, HTTPS tunnels, vehicle SSH Access and R2 buckets remain in use. The Suite application's old Workers and D1 databases were deleted. The documentation site retains its separate Worker.