Operations Overview

This section contains operational setup guides for running and maintaining the platform infrastructure.

---

Setup Guides

• pnpm Installation on Ubuntu — How to install pnpm on Ubuntu 22.04 servers
• Puppeteer in Monorepo — Setting up Puppeteer correctly in a pnpm monorepo
• EC2 Server Setup — Full step-by-step guide to provisioning and configuring an Ubuntu EC2 instance for the backend

---

Common Operations

Deploying the Backend

# Normal redeploy (zero-downtime)
pnpm deploy:backend

# First deploy or ecosystem config changed
pnpm deploy:backend:fresh

Checking Backend Health

# SSH into EC2
pm2 status                          # PM2 process status
pm2 logs prod-logistech --lines 50  # Recent logs

Restarting nginx

sudo systemctl restart nginx
sudo nginx -t                        # Test nginx config before restart

SSL Certificate Renewal

Certbot auto-renews certificates. To check or manually renew:

sudo certbot renew --dry-run   # Test renewal
sudo certbot renew             # Force renew

Database Backups

MongoDB backups should be scheduled via mongodump or Atlas automated backups:

mongodump --uri="$MONGODB_URI" --out=/backups/$(date +%Y%m%d)