How do I install the Nestjs Deployment skill?

Run npx skillmds@latest add filippodesilva/nestjs-deployment in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Nestjs Deployment safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nestjs Deployment?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nestjs Deployment free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Nestjs Deployment?

FilippoDeSilva (@filippodesilva) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nestjs Deployment by filippodesilva

Name: Nestjs Deployment
Author: FilippoDeSilva

Nestjs Deployment

Containerize NestJS apps with multi-stage Docker builds, tune Node.js memory, and implement graceful shutdown hooks. Use when writing Dockerfiles, configuring K8s deployments, or adding shutdown hooks for NestJS.

FilippoDeSilva 7e1fabb 3 files · 4.8 KB Updated Sep 17, 2026

File contents

Deployment & Ops Standards

Priority: P1 (OPERATIONAL)

Workflow: Containerize NestJS App

Write multi-stage Dockerfile — Build stage installs devDeps and runs nest build; run stage copies only dist and pruned node_modules.
Set non-root user — Add USER node to Dockerfile.
Tune memory — Set --max-old-space-size to ~75% of container memory limit.
Enable shutdown hooks — Call app.enableShutdownHooks() in main.ts.
Add K8s pre-stop — Configure 5-10s sleep pre-stop hook for LB draining.

Dockerfile Example

See implementation examples

Runtime Tuning (Node.js)

Memory Config: Container memory != Node memory.
Rule: Explicitly set Max Old Space.
Command: node --max-old-space-size=XXX dist/main
Calculation: Set to ~75-80% of Kubernetes Limit. (Limit: 1GB -> OldSpace: 800MB).
Graceful Shutdown:
Signal: Listen to SIGTERM.
NestJS: app.enableShutdownHooks() mandatory.
Sleep: Add "Pre-Stop" sleep in K8s (5-10s) to allow Load Balancer to drain connections before Node process stops accepting traffic.

Init Patterns

Database Migrations:
Anti-Pattern: Running migration in main.ts on startup.
Pro Pattern: Use Init Container in Kubernetes that runs npm run typeorm:migration:run before app container starts.

Environment Variables & CI/CD

CI/CD Pipelines (GitHub, GitLab, Azure, etc.):
If you modify src/config/env.validation.ts to add new environment variable, you MUST map it explicitly in your deployment pipeline/infrastructure-as-code.
Platform Context:
Cloud Run/ECS: Variables must explicitly passed in service definition.
Kubernetes: New variables must added to Deployment manifest or ConfigMap/Secret.
Lambda/Serverless: Must added to serverless.yml or provider console.
Fundamental Rule: Application code configuration changes "breaking changes" for infrastructure layer. Never assume environment inheritance.

Anti-Patterns

No migrations in main.ts: Use K8s Init Containers or pre-deploy CI steps for migration runs.
No root user in Docker: Always add USER node to Dockerfile; running as root security risk.
No unbounded Node heap: Set --max-old-space-size to ~75% of container memory limit.

---name: nestjs-deploymentdescription: Containerize NestJS apps with multi-stage Docker builds, tune Node.js memory, and implement graceful shutdown hooks. Use when writing Dockerfiles, configuring K8s deployments, or adding shutdown hooks for NestJS.license: MIT---# Deployment & Ops Standards## **Priority: P1 (OPERATIONAL)**## Workflow: Containerize NestJS App1. **Write multi-stage Dockerfile** — Build stage installs devDeps and runs `nest build`; run stage copies only `dist` and pruned `node_modules`.2. **Set non-root user** — Add `USER node` to Dockerfile.3. **Tune memory** — Set `--max-old-space-size` to ~75% of container memory limit.4. **Enable shutdown hooks** — Call `app.enableShutdownHooks()` in `main.ts`.5. **Add K8s pre-stop** — Configure 5-10s sleep pre-stop hook for LB draining.## Dockerfile ExampleSee [implementation examples](references/example.md)## Runtime Tuning (Node.js)- **Memory Config**: Container memory != Node memory. - **Rule**: Explicitly set Max Old Space. - **Command**: `node --max-old-space-size=XXX dist/main` - **Calculation**: Set to ~75-80% of Kubernetes Limit. (Limit: 1GB -> OldSpace: 800MB).- **Graceful Shutdown**: - **Signal**: Listen to `SIGTERM`. - **NestJS**: `app.enableShutdownHooks()` mandatory. - **Sleep**: Add "Pre-Stop" sleep in K8s (5-10s) to allow Load Balancer to drain connections before Node process stops accepting traffic.## Init Patterns- **Database Migrations**: - **Anti-Pattern**: Running migration in `main.ts` on startup. - **Pro Pattern**: Use **Init Container** in Kubernetes that runs `npm run typeorm:migration:run` before app container starts.## Environment Variables & CI/CD- **CI/CD Pipelines (GitHub, GitLab, Azure, etc.)**: - If you modify `src/config/env.validation.ts` to add new environment variable, you **MUST** map it explicitly in your deployment pipeline/infrastructure-as-code. - **Platform Context**: - **Cloud Run/ECS**: Variables must explicitly passed in service definition. - **Kubernetes**: New variables must added to `Deployment` manifest or `ConfigMap`/`Secret`. - **Lambda/Serverless**: Must added to `serverless.yml` or provider console. - **Fundamental Rule**: Application code configuration changes "breaking changes" for infrastructure layer. Never assume environment inheritance.## Anti-Patterns- **No migrations in main.ts**: Use K8s Init Containers or pre-deploy CI steps for migration runs.- **No root user in Docker**: Always add `USER node` to Dockerfile; running as root security risk.- **No unbounded Node heap**: Set `--max-old-space-size` to ~75% of container memory limit.

Frequently asked questions