Deploy a NestJS App with Serverless Framework

Deploy a NestJS App with Serverless Framework

Serverless Framework is currently the most known solution to deploy a serverless application. It has the same assets as many other serverless frameworks: It's easy, you can deploy your app with one command. It's fast, you deploy your application in one minute or less.

Originally published by Jean Delevoye at

We are very enthusiastic about NestJS framework. It is quite young but we consider it currently one of the best NodeJS frameworks. Recently, we asked ourselves if it was possible to deploy serverless NestJS applications.

Serverless is a new paradigm that will help you to quickly deploy your back-end application with cutting costs. If you want to learn more about serverless, check this article.

Serverless Framework is currently the most known solution to deploy a serverless application. It has the same assets as many other serverless frameworks:

  • It’s easy, you can deploy your app with one command
  • It’s fast, you deploy your application in one minute or less
  • Last but not least, it allows you to deploy your app without using AWS dashboard

Many other serverless frameworks could help you: Claudia.jsUpArchitect, etc. However the popularity of Serverless Framework positions it a step ahead:

  • It has good documentation and a lot of plugins
  • It is Cloud agnostic: you can deploy on different clouds with the same command

That’s the solution we want to use for our app!

This tutorial will give you the keys to deploy an already existing NestJS API with the Serverless Framework. It will not give you any detail on how to create your own NestJS application or how to test it. We will go through all the steps from configuring your nestJS application and testing it offline to deploying it. Before getting started, let’s introduce Serverless Framework!

If you want to see directly the code of a serverless deployable nestJS application, here is the Github of my project.


  • AWS account
  • Node.js
  • Npm (or yarn)
  • A NestJS application
Serverless Framework

Cloud Functions and Serverless

In order to better understand the role of Serverless framework let’s remind what the serverless paradigm is:

Serverless is a method of deploying and running applications on cloud infrastructure, on a pay-per-use basis and without renting or buying servers. Instead of you, the serverless platform provider is responsible for capacity planning, scaling, balancing, and monitoring; the provider is also able to treat your applications as functions.

These functions mentioned in the quote above are Cloud Functions. Cloud functions like AWS Lambda, Google Cloud Functions, Azure Function are independent units of development, like a microservice. They are merely code designed to be deployed in the Cloud and to perform small tasks.

Serverless Framework presentation

The Serverless framework can build such cloud functions from your application code. Once built, it deploys these functions in your Cloud Provider. This operation takes less than a minute.

The framework supports multiple languages like Node.js, Python, Java. Its biggest asset apart for its swiftness is its ease of use and its agnosticism in regards to Cloud Platforms. It is compatible with AWS, Microsoft Azure and Google Cloud Provider. Besides, Serverless Framework allows deploying fully configured cloud functions. You can have an AWS Lambda running without using AWS dashboard.

Serverless Framework setup

Install Serverless-cli with this simple command.

# Installing the serverless cli
npm install -g serverless

Once installed you have to set up your Cloud provider credential. If you don’t have an AWS account already, create one. Create a user with the AWS IAM service and get its access key and secret access key.

Now create the file .aws/credentials in your user root directory with the following content:

aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY

That’s all with Serverless configuration! Now let’s focus on your NestJS app deployment.

Deploy your NestJS app

From here the tutorial will only focus on the deployment of AWS Lambda functions. Here is a diagram of a typical serverless application with AWS.

API Gateway creates a REST API in front of your lambdas. By default, each Serverless project generates a new API Gateway. You can configure Serverless Framework to share API Gateway and API ressources.

Create your handler

For Serverless to build your lambda you have to wrap your application. You need to provide an entry point for Serverless to compile your code in a lambda function. This entry point will be a handler object exported in the file lambda.ts. This entry point is not the same for each Cloud Provider.

Create the lambda.ts file in the src folder of your application.

The main.ts file could also serve as an entry point for Serverless but it is a better practice to let the code of your app unchanged.

├── package.json
├── serverless.yml
├── tsconfig.json
└── src
    ├── app.controller.ts
    ├── app.module.ts
    ├── app.service.ts
    ├── lambda.ts
    ├── main.ts
    └── photo
        ├── photo.controller.ts
        ├── photo.entity.ts
        ├── photo.module.ts
        ├── photo.service.ts
        └── interfaces
            └── photo.dto.ts

If you were developing an Express API, for example, you could use the package serverless-http to create your entry point. With a NestJS app, it is a bit harder though, the package is not working currently with NestJS framework. As you may know, under the hood, Nest makes use of Express by default. To create a Serverless entry point with Nest you will need full control of the express lifecycle. You need to use the function NestFactory to do so.

const expressApp = express();
const nestApp = await NestFactory.create(AppModule, new ExpressAdapter(expressApp)

You will also need to import functions from the plugin aws-serverless-express and aws-lambda. They will help convert your app into a server able to handle AWS events.

Install the plugin aws-lambda and aws-serverless-express in your project.

npm install --save aws-serverless-express
npm install --save aws-lambda

In the lambda.ts file place the following code:

// lambda.ts
import { Handler, Context } from 'aws-lambda';
import { Server } from 'http';
import { createServer, proxy } from 'aws-serverless-express';
import { eventContext } from 'aws-serverless-express/middleware';

import { NestFactory } from '@nestjs/core';
import { ExpressAdapter } from '@nestjs/platform-express';
import { AppModule } from './app.module';

const express = require('express');

// NOTE: If you get ERR_CONTENT_DECODING_FAILED in your browser, this
// is likely due to a compressed response (e.g. gzip) which has not
// been handled correctly by aws-serverless-express and/or API
// Gateway. Add the necessary MIME types to binaryMimeTypes below
const binaryMimeTypes: string[] = [];

let cachedServer: Server;

// Create the Nest.js server and convert it into an Express.js server
async function bootstrapServer(): Promise<Server> {
if (!cachedServer) {
const expressApp = express();
const nestApp = await NestFactory.create(AppModule, new
await nestApp.init();
cachedServer = createServer(expressApp, undefined,
return cachedServer;

// Export the handler : the entry point of the Lambda function
export const handler: Handler = async (event: any, context: Context) => {
cachedServer = await bootstrapServer();
return proxy(cachedServer, event, context, 'PROMISE').promise;

Configure serverless

Once the lambda entry point is created, configure Serverless to build this lambda. Create a file serverless.yaml at the root of your project with the content:

name: nest-serverless-framework-demo


  • '@hewmen/serverless-plugin-typescript'
  • serverless-plugin-optimize
  • serverless-offline

name: aws
runtime: nodejs8.10

main: # The name of the lambda function

The module 'handler' is exported in the file 'src/lambda'

handler: src/lambda.handler
- http:
method: any
path: /{any+}

With this configuration, Serverless will create the Lambda function main that will serve all the routes and methods of the API.

If you are using NestJS with Typescript you will need to install : @hewmen/serverless-plugin-typescript plugin in order to allow Serverless Framework to compile your code.

We will install these dependencies:

npm install --save-dev @hewmen/serverless-plugin-typescript
npm install --save-dev serverless-plugin-optimize
npm install --save-dev serverless-offline plugin

That’s all with your app configuration!


Before deploying your app, let’s verify that our Serverless configuration is OK. We can test your app with the command:

sls offline start

Your app will run on the port 3000 by default.

To deploy your app, just run the following command:

sls deploy

This command will create a zip file containing your Lambda function in the folder .serverless of your app and deploy it. Your function is now accessible in the AWS Cloud. You can now test it.

If you want to access the log of your lambda without using the AWS CloudWatch tool you can run the command:

sls logs -f main

Serverless will fetch your lambda logs from the last 10 minutes. If you want more details on how to get your app logs, check the serverless doc.

Go further

Adding files

Your app may read from files that are not imported in the code like environment variables files. Let’s imagine a situation where your app read variables from a .env file. If you deploy this app on a lambda you will get an error cause your function won’t see this file. To solve this issue you can add these lines to your serverless.yaml file:

individually: true
- .env

Cold start

If you are used to deploying Lambdas you probably know the issue of cold start. A cold start is a latency experienced when you trigger a function. A cold start only happens if there is no idle container available waiting to run the code. This is all invisible to the user and AWS has full control over when to kill containers (ref:

Serverless Framework allows you to easily tackle this problem.

Serverless-plugin-warmup will prevent unwanted latency due to cold starts.

npm install --save-dev serverless-plugin-warmup

Add the following lines to your serverles.yaml file:


  • '@hewmen/serverless-plugin-typescript'
  • serverless-plugin-optimize
  • serverless-offline
  • serverless-plugin-warmup


Enable warmup on all functions (only for production and staging)

enabled: true

Check this article if you want to learn more about lambda warming up and in which conditions you should use it.

Multiple Lambdas functions?

There is a major interrogation with serverless: should you have few monolithic functions or many single-purpose functions?

Of course, you could create a lambda for each of your API routes. After all with the serverless approach, you pay the consumption of the functions, not the deployment of the functions. Every route of an application is not used as much. Dividing the handler of the most used routes into many handlers will allow you to create multiple lambdas. Each of these lambdas could be faster doing so. Faster functions mean that they will cost you less and that your app will be more efficient.

Check the serverless doc if you want to learn more about creating multiple functions.

This article focused on how to make a monolithic lambda function. It’s the most convenient and fast solution with an already existing app. Moving your backend application on a server to a monolith lambda function could already save you time and money.

Here is the Github of an example project using NestJS and Serverless Framework.

Enjoy your first serverless NestJS application!

Originally published by Jean Delevoye at


Thanks for reading

If you liked this post, share it with all of your programming buddies!

Follow me on Facebook | Twitter

Learn More

☞ NestJS Zero to Hero - Modern TypeScript Back-end Development

☞ The Complete Node.js Developer Course (3rd Edition)

☞ Complete Next.js with React & Node - Beautiful Portfolio App

☞ Angular & NodeJS - The MEAN Stack Guide

☞ NodeJS - The Complete Guide (incl. MVC, REST APIs, GraphQL)

☞ Docker for Node.js Projects From a Docker Captain

☞ Intro To MySQL With Node.js - Learn To Use MySQL with Node!

☞ Node.js Absolute Beginners Guide - Learn Node From Scratch

Top Vue.js Developers in USA

Top Vue.js Developers in USA

Vue.js is an extensively popular JavaScript framework with which you can create powerful as well as interactive interfaces. Vue.js is the best framework when it comes to building a single web and mobile apps.

We, at HireFullStackDeveloperIndia, implement the right strategic approach to offer a wide variety through customized Vue.js development services to suit your requirements at most competitive prices.

Vue.js is an open-source JavaScript framework that is incredibly progressive and adoptive and majorly used to build a breathtaking user interface. Vue.js is efficient to create advanced web page applications.

Vue.js gets its strength from the flexible JavaScript library to build an enthralling user interface. As the core of Vue.js is concentrated which provides a variety of interactive components for the web and gives real-time implementation. It gives freedom to developers by giving fluidity and eases the integration process with existing projects and other libraries that enables to structure of a highly customizable application.

Vue.js is a scalable framework with a robust in-build stack that can extend itself to operate apps of any proportion. Moreover, vue.js is the best framework to seamlessly create astonishing single-page applications.

Our Vue.js developers have gained tremendous expertise by delivering services to clients worldwide over multiple industries in the area of front-end development. Our adept developers are experts in Vue development and can provide the best value-added user interfaces and web apps.

We assure our clients to have a prime user interface that reaches end-users and target the audience with the exceptional user experience across a variety of devices and platforms. Our expert team of developers serves your business to move ahead on the path of success, where your enterprise can have an advantage over others.

Here are some key benefits that you can avail when you decide to hire vue.js developers in USA from HireFullStackDeveloperIndia:

  • A team of Vue.js developers of your choice
  • 100% guaranteed client satisfaction
  • Integrity and Transparency
  • Free no-obligation quote
  • Portal development solutions
  • Interactive Dashboards over a wide array of devices
  • Vue.js music and video streaming apps
  • Flexible engagement model
  • A free project manager with your team
  • 24*7 communication with your preferred means

If you are looking to hire React Native developers in USA, then choosing HireFullStackDeveloperIndia would be the best as we offer some of the best talents when it comes to Vue.js.

Hire Node JS Developer from Expert Node JS Development Company

Hire Node JS Developer from Expert Node JS Development Company

NodeJS Development Company-Hire Node JS developer from the most prominent NodeJS development company, Mobiweb and get remarkable Node.js app development services.

Are you looking to hire the most talented and expert Node JS developers for your valuable web application projects and mobile app development projects or you want to migrate application on Node JS framework? Then you have to hire Node JS developer from leading offshore Node JS development company Mobiweb Technologies. We have a team of developers with extensive experience in developing Node JS based applications whether it is web based or mobile app based.