Deploy AdonisJS with Risved

Requires Risved 0.22.0 or newer.

Risved detects @adonisjs/core and builds AdonisJS projects with Node.js 24. Other frameworks keep their existing runtime version.

Build and start

Set the package.json build script to node ace build. Risved preserves the standalone build directory and production dependencies, then starts node bin/server.js from /app/build.

Environment variables

The template supplies NODE_ENV=production, HOST=0.0.0.0, and PORT=3000. Add your application's other required variables, including APP_KEY, in Risved. Check start/env.ts for the complete list. Keep the same APP_KEY across deployments.

Database and storage

If using Lucid, configure a release command such as node ace migration:run --force. Release commands run from the build-stage project root. Store local uploads and SQLite files under the persistent /app/data directory.

For monorepos, select the backend directory and ensure its dependencies can be installed independently. Shared workspace packages need a workspace-aware build configuration.

See the AdonisJS deployment guide.