Skip to main content

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.

VariableValue
SUITE_DATABASE_PATHabsolute path of the SQLite file; deployed path /var/lib/suite/suite.db
OIDC_ISSUERthe environment's public HTTPS origin
R2_ENDPOINThttps://<account id>.r2.cloudflarestorage.com
R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEYcredentials restricted to that environment's buckets
R2_BUCKET_MEDIA, R2_BUCKET_MEDIA_PUBLIC, R2_BUCKET_AVATARbucket 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.