Quickstart: Deploy a NestJS App

This guide explains how to deploy a NestJS application to seenode.

Deploy a NestJS Template

Get started in seconds by deploying our pre-configured NestJS template. This example is ready to deploy and reflects the structure discussed in this guide.

NestJS Template

Deploy a NestJS project pre-configured for production.

Deploying an Existing NestJS Project

Follow these steps to prepare and deploy your NestJS project.

You can fork our existing NestJS quickstart project.

Once you’ve forked the repository, you can start your 7-day free trial by deploying it on seenode.

npm i -g @nestjs/cli
nest new your-project-name

pnpm i -g @nestjs/cli
nest new your-project-name

yarn global add @nestjs/cli
nest new your-project-name

Prepare Your Project for Production

Your project structure should be ready for deployment. The NestJS starter template is well-configured for production builds.

Project Structure

A typical NestJS project contains the following key files:
- Directoryyour-nestjs-project/
  - package.json
  - nest-cli.json
  - tsconfig.json
  - Directorysrc/
    main.ts // The application entry point
    app.module.ts // The root module of the application
    app.controller.ts
    app.service.ts
For brevity, the example repository omits testing files (*.spec.ts, jest-e2e.json, etc.) that are generated by the NestJS CLI.

By default, a new NestJS application listens on port 3000. To deploy on seenode, you should modify src/main.ts to listen on the port defined in an environment variable. You can then set this PORT variable in your service’s environment settings on seenode.
src/main.ts
```
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(process.env.PORT || 3000);
}
bootstrap();
```
Deploy on seenode

Follow these steps to deploy your NestJS application:
1. First, create a new Web Service from the seenode Dashboard and connect your NestJS project’s Git repository.
2. Configure your build and start commands in the settings. seenode will attempt to detect these automatically for a NestJS project. A common setup is:
  - Build Command:
    npm i && npm run build
  - Start Command:
    npm run start:prod
3. Configure any production environment variables your application needs in the Environment tab. Make sure to set a PORT variable (e.g., 8080). seenode does not automatically assign one.
4. Choose your preferred instance size and create your service.
5. Watch your deployment progress in real-time through the Logs tab.
6. Once complete, your NestJS application will be accessible via your service’s URL.
If your deployment fails, the first place to check is the Logs tab in your seenode service dashboard. Build and runtime logs often contain valuable information for diagnosing issues.

Next Steps

Now that your NestJS application is deployed, here are some things you might want to do next:

Set up a Custom Domain (Coming Soon)

Configure a custom domain to point to your new web service.

Connect to a Database

Instantly scaffold and connect PostgreSQL and MySQL databases