Docker Fastify RESTful API

Node.js RESTful API boilerplate using Traefik, Docker, Docker Compose, Fastify, JWT and Mongodb.

1. Node.js >= 20
2. Docker
3. Docker compose

src/
├── index.js        # entry point: boot + graceful shutdown
├── app.js          # builds the Fastify instance (plugins, error handling)
├── routes.js       # mounts the modules under /api/v1
├── plugins/        # cross-cutting infrastructure (db, auth, sentry)
├── modules/        # one folder per business domain
│   ├── movies/     # movies.routes / .controller / .schemas / .model
│   └── users/      # users.routes / .controller / .schemas / .model
└── shared/         # generic building blocks (enums, errors, utils, validators)

The dependency rule: modules/ may import from shared/, never the other way around, and modules do not import from each other.

Install packages using docker:

docker run --rm -it \
-v ${PWD}:/usr/src/app \
-w /usr/src/app \
node:22-alpine npm i

Windows users should switch the PWD variable to your current directory. Alternatively, you can run npm install as follows:

docker-compose run --rm api npm install

Or if you have node installed in your system, install using npm:

npm install

1. Rename the .env.example file to .env and fill variables. The SENTRY_DSN variable is not obligatory.

2. Edit your hosts file with:

127.0.0.1 fastify.localhost

In the root of project, run:

docker-compose up

All /api/v1/movies routes require a Authorization: Bearer <token> header (get a token from /api/v1/users/auth). Invalid ids return 400, duplicated emails return 409, and login/register are rate limited (5 requests per minute).

The test suite uses the built-in node:test runner against an in-memory MongoDB (no Docker needed):

npm test

• Healthcheck

Request

curl -i --request GET 'http://fastify.localhost/api/v1'

Response

{
  "message": "Fastify API is on fire"
}

I exported Insomnia collection/data for so you can test all the endpoints.

To access Traefik dashboard, simple access in your browser:

http://localhost:8080

Happy coding!