Deploying Node.js Applications

⏱ Estimated reading time: 2 min

Deployment is the process of making a Node.js application available to users over the internet.
A proper deployment ensures performance, security, scalability, and reliability.

1. Pre-Deployment Checklist

Before deploying a Node.js app:

• Remove hardcoded values

• Use environment variables

• Handle errors properly

• Set production scripts

• Optimize dependencies

2. Production Configuration

Set Environment Mode

NODE_ENV=production

console.log(process.env.NODE_ENV);

✔ Enables performance optimizations

3. Preparing the Application

Package.json Scripts

"scripts": {
  "start": "node app.js"
}

Install Production Dependencies Only

npm install --production

4. Common Deployment Methods

5. Deploying to a Cloud Platform (Overview)

5.1 Deploying on Heroku (Concept)

Steps:

1. Create Heroku app

2. Push code using Git

3. Set environment variables

4. App runs automatically

✔ Simple and beginner-friendly

5.2 Deploying on Render / Railway

• Auto builds from GitHub

• Built-in environment variables

• Free and paid plans

5.3 Deploying on VPS (Linux Server)

Requires:

• Node.js installation

• Process manager

• Reverse proxy

✔ More control and flexibility

6. Using PM2 (Process Manager)

PM2 keeps apps running and restarts on crashes.

Install PM2

npm install -g pm2

Start App with PM2

pm2 start app.js

PM2 Commands

pm2 list
pm2 restart app
pm2 stop app
pm2 logs

7. Using Nginx as Reverse Proxy

Nginx handles:

• Load balancing

• SSL termination

• Static content

Client → Nginx → Node.js App

8. Environment Variables in Production

Set environment variables securely:

• Cloud dashboard

• .env (not committed)

• OS-level variables

9. Security Considerations

• Use HTTPS

• Hide sensitive data

• Enable CORS properly

• Use helmet middleware

• Keep dependencies updated

10. Scaling Node.js Applications

• Use clustering

• Horizontal scaling

• Load balancers

• Stateless design

11. Logging and Monitoring

• PM2 logs

• Winston / Pino

• Monitoring tools (New Relic, Grafana)

12. Common Deployment Errors

❌ App crashes after deployment
❌ Missing environment variables
❌ Port not exposed
❌ Dependency issues

13. Typical Deployment Flow

Local Development
      ↓
Git Repository
      ↓
Build & Config
      ↓
Production Server
      ↓
Live Application

14. Summary

• Deployment makes Node.js apps live

• Requires proper configuration and security

• PM2 ensures uptime

• Cloud platforms simplify deployment