Skip to content
← All solutions
AdonisJS logo

Frameworks solution

Run AdonisJS Locally with FlyEnv

AdonisJS applications combine a TypeScript Node.js runtime with a database, optional Redis, and a local web server. FlyEnv coordinates those services.

Local project stack

Services FlyEnv can manage around AdonisJS

About AdonisJS

AdonisJS is a TypeScript-first Node.js framework with an integrated application structure for routing, validation, authentication, Lucid ORM, Edge templates, and command-line workflows. It is designed for full-stack applications rather than only a thin HTTP layer.

Adonis projects commonly run Node.js, use `node ace` commands for migrations and tasks, and connect through Lucid to a configured SQL database. Redis and queue workers are useful when the project enables queues or cache-backed features, not by default.

Core capabilities

  • Lucid ORM
  • Node Ace CLI
  • Authentication
  • Validation
  • Edge Templates
  • Route Middleware

Common use cases

  • Database-backed web applications
  • TypeScript JSON APIs
  • Authentication-heavy portals
  • Server-rendered dashboards
  • Background job workflows

AdonisJS follows its own CLI and application conventions

Its `.env` configuration and Ace commands identify the runtime services a project actually uses.

Node.js and package manager
Runs `node ace serve --hmr`, TypeScript compilation, and repository scripts.
SQL database and Lucid migrations
MySQL or PostgreSQL is needed when the configured Lucid connection stores application data.
Redis and queue worker
Run these only for projects configured with cache, queue, or session drivers that depend on Redis.
Asset workflow
Frontend assets may add Vite or another build task when the application includes an interactive UI.

Project resources

For installation commands, supported versions, and project-specific configuration, refer to the official AdonisJS documentation.

Typical local stack

The exact services depend on the project, its release, and its local configuration. This is a common local setup, not a fixed requirement.

ComponentTypical role
Node.jsRuns the AdonisJS application.
MySQLPostgreSQLStores application data.
RedisMay support cache and queues.
NginxCaddyMay serve a local domain.

How FlyEnv helps

  • Use the project runtime

    Keep Node.js aligned with the project.

  • Run the configured database

    Start only the data services the application needs.

  • Group app services

    Launch the application and dependencies together.

Set up the local environment

Project installation stays with the upstream documentation. FlyEnv manages the runtimes, databases, web servers, and supporting services around it.

  1. 1Install the project according to AdonisJS documentation.
  2. 2Select the required Node.js runtime.
  3. 3Start the configured database and Redis services.
  4. 4Configure a local domain and HTTPS when useful.

Ready to run AdonisJS locally?

Use FlyEnv to manage the runtimes, databases, web servers, and services around your local AdonisJS environment.

Download FlyEnv

Have questions using FlyEnv?