Full-Stack VPS Deployment Commands – FastAPI, Next.js & PM2

VPS & System Management
Directory & File Management
Nginx Management
SSL Management
Git & GitHub Commands
PostgreSQL Management
FastAPI Server Management
Next.js Management
PM2 Management
Networking & Ports
Backup & Recovery
Emergency & Debugging

VPS & System Management

Check current user:

bash

whoami

Check current directory:

bash

pwd

Connect to server:

bash

ssh username@server_ip

Connect using SSH key:

bash

ssh -i /path/to/private_key username@server_ip

Copy file to server:

bash

scp file.txt username@server_ip:/path/to/destination

2. System Updates & Package Management

Update package list:

bash

sudo apt update

Upgrade installed packages:

bash

sudo apt upgrade -y

Full upgrade:

bash

sudo apt full-upgrade -y

Install package:

bash

sudo apt install package_name

Remove package:

bash

sudo apt remove package_name

List installed packages:

bash

dpkg -l

3. User Management

Create new user:

bash

sudo adduser username

Add user to sudo group:

bash

sudo usermod -aG sudo username

Switch user:

bash

su - username

List users:

bash

cut -d: -f1 /etc/passwd

4. Service Management (systemctl)

Check service status:

bash

systemctl status service_name

Start service:

bash

sudo systemctl start service_name

Stop service:

bash

sudo systemctl stop service_name

Restart service:

bash

sudo systemctl restart service_name

Reload service:

bash

sudo systemctl reload service_name

Enable on boot:

bash

sudo systemctl enable service_name

Disable on boot:

bash

sudo systemctl disable service_name

List running services:

bash

systemctl list-units --type=service

5. Process Management

Show running processes:

bash

ps aux

Interactive process viewer:

bash

top

If installed:

bash

htop

Kill process by PID:

bash

kill PID

Force kill:

bash

kill -9 PID

Find process by name:

bash

ps aux | grep process_name

6. System Monitoring (CPU, RAM, Disk)

Check memory:

bash

free -m

Check disk usage:

bash

df -h

Check folder size:

bash

du -sh folder_name

Check uptime:

bash

uptime

7. Firewall (UFW)

Check firewall status:

bash

sudo ufw status

Enable firewall:

bash

sudo ufw enable

Allow port:

bash

sudo ufw allow 8000

Allow specific service:

bash

sudo ufw allow 'Nginx Full'

Delete rule:

bash

sudo ufw delete allow 8000

View environment variables:

bash

printenv

Temporary variable:

bash

export VARIABLE_NAME=value

Edit global environment:

bash

sudo nano /etc/environment

Reload bash:

bash

source ~/.bashrc

9. Cron Jobs

Edit cron jobs:

bash

crontab -e

List cron jobs:

bash

crontab -l

10. Time & Timezone

Check current time:

bash

date

Check timezone:

bash

timedatectl

Set timezone:

bash

sudo timedatectl set-timezone Asia/Karachi

11. Reboot & Shutdown

Reboot server:

bash

sudo reboot

Shutdown server:

bash

sudo shutdown now

Schedule shutdown:

bash

sudo shutdown +10

Directory & File Management

Print current directory:

bash

pwd

Change directory:

bash

cd /path/to/directory

Go back one directory:

bash

cd ..

Go to home directory:

bash

cd ~

List directory tree (if tree installed):

bash

tree

2. Listing Files

List files in current directory:

bash

ls

Long listing with permissions, owner, size:

bash

ls -l

Include hidden files:

bash

ls -a

Human-readable sizes:

bash

ls -lh

Full listing (long + hidden):

bash

ls -lah

3. Creating Files & Folders

Create a new directory:

bash

mkdir folder_name

Create nested directories:

bash

mkdir -p parent/child/grandchild

Create an empty file:

bash

touch file_name

Create file with content:

bash

echo "Hello World" > file_name

4. Copy, Move, Rename

Copy file:

bash

cp source_file destination_file

Copy directory recursively:

bash

cp -r source_folder destination_folder

Move / rename file or folder:

bash

mv old_name new_name

5. Delete Operations

Delete file:

bash

rm file_name

Delete directory recursively:

bash

rm -r folder_name

Force delete without prompt:

bash

rm -rf folder_name_or_file

6. File Permissions

View file permissions:

bash

ls -l

Change permissions:

bash

chmod 755 file_name

Change owner:

bash

sudo chown user:group file_name

Change recursively:

bash

sudo chown -R user:group folder_name

7. File Compression & Archiving

Compress folder to tar.gz:

bash

tar -czvf archive_name.tar.gz folder_name

Extract tar.gz:

bash

tar -xzvf archive_name.tar.gz

Zip a folder:

bash

zip -r archive_name.zip folder_name

Unzip:

bash

unzip archive_name.zip

8. File Search

Find files by name:

bash

find /path -name "file_name"

Search inside files:

bash

grep "search_text" file_name

grep -r "search_text" /path/to/folder

bash

grep -r "search_text" /path/to/folder

9. Viewing File Content

View file:

bash

cat file_name

View with paging:

bash

less file_name

Scroll forward/backward:

bash

more file_name

Tail last lines:

bash

tail file_name

Follow log file:

bash

tail -f file_name

Head first lines:

bash

head file_name

10. Disk Usage & Storage

Check disk usage for file/folder:

bash

du -sh folder_name

Check all folder sizes in current directory:

bash

du -sh *

Check free disk space:

bash

df -h

Nginx Management

1. Install & Remove Nginx

Install Nginx:

bash

sudo apt update
sudo apt install nginx -y

Remove Nginx:

bash

sudo apt remove nginx -y

Purge Nginx completely (config + data):

bash

sudo apt purge nginx -y
sudo apt autoremove -y

2. Start, Stop, Restart

Start Nginx:

bash

sudo systemctl start nginx

Stop Nginx:

bash

sudo systemctl stop nginx

Restart Nginx:

bash

sudo systemctl restart nginx

Reload Nginx (keep running connections):

bash

sudo systemctl reload nginx

Enable Nginx on boot:

bash

sudo systemctl enable nginx

Disable Nginx on boot:

bash

sudo systemctl disable nginx

Check Nginx status:

bash

systemctl status nginx

3. Configuration Files

Nginx main config file:

bash

/etc/nginx/nginx.conf

Default server block:

bash

/etc/nginx/sites-available/default

Available sites directory:

bash

/etc/nginx/sites-available/

Enabled sites directory:

bash

/etc/nginx/sites-enabled/

Test configuration syntax:

bash

sudo nginx -t

Reload after changes:

bash

sudo systemctl reload nginx

4. Virtual Hosts / Server Blocks

Create a new server block:

bash

sudo nano /etc/nginx/sites-available/example.com

Enable site:

bash

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

Disable site:

bash

sudo rm /etc/nginx/sites-enabled/example.com

Test new configuration:

bash

sudo nginx -t

Reload Nginx to apply changes:

bash

sudo systemctl reload nginx

5. Reverse Proxy Setup (FastAPI / Next.js)

Example for FastAPI on port 8000:

bash

server {
    listen 80;
    server_name example.com;
 
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

For Next.js on port 3000:

bash

server {
    listen 80;
    server_name example.com;
 
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

6. Testing Configuration

Test syntax before reload:

bash

sudo nginx -t

Check Nginx version:

bash

nginx -v

Check which ports Nginx is listening on:

bash

sudo lsof -i :80
sudo lsof -i :443

7. Nginx Logs

Access logs:

bash

tail -f /var/log/nginx/access.log

Error logs:

bash

tail -f /var/log/nginx/error.log

Check logs for a specific site:

bash

tail -f /var/log/nginx/example.com-error.log

8. Common Nginx Errors & Fixes

502 Bad Gateway:

bash

# Check backend service
sudo systemctl status fastapi_service_name
sudo systemctl restart fastapi_service_name

Port conflicts:

bash

sudo lsof -i :80
sudo lsof -i :443

Permission denied errors:

bash

sudo chown -R www-data:www-data /var/www/example.com
sudo chmod -R 755 /var/www/example.com

SSL Management

1. Install Certbot

Update package list:

bash

sudo apt update

Install Certbot and Nginx plugin:

bash

sudo apt install certbot python3-certbot-nginx -y

Check Certbot version:

bash

certbot --version

2. Generate SSL Certificate

Automatic SSL for Nginx:

bash

sudo certbot --nginx -d example.com -d www.example.com

Manual SSL (if needed):

bash

sudo certbot certonly --nginx -d example.com -d www.example.com

Check the generated certificate files:

bash

ls /etc/letsencrypt/live/example.com/

3. Auto Renewal

Check auto-renewal status:

bash

sudo systemctl status certbot.timer

Test renewal manually:

bash

sudo certbot renew --dry-run

Renew all certificates:

bash

sudo certbot renew

4. Test SSL

Check SSL on your server:

bash

sudo nginx -t

Check certificate expiration:

bash

sudo certbot certificates

Test using curl:

bash

curl -Ik https://example.com

5. Remove / Revoke Certificate

Revoke certificate:

bash

sudo certbot revoke --cert-path /etc/letsencrypt/live/example.com/fullchain.pem

Delete certificate completely:

bash

sudo certbot delete --cert-name example.com

6. Force HTTPS Redirect

Edit Nginx server block:

bash

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

7. Troubleshooting SSL

Certificate not found:

bash

sudo ls /etc/letsencrypt/live/

Port 443 blocked:

bash

sudo ufw allow 443
sudo ufw status

Renewal failed:

bash

sudo certbot renew --dry-run
sudo systemctl restart nginx

Browser shows old certificate:

bash

sudo systemctl reload nginx

Git & GitHub Commands

1. Repository Setup

Initialize a new Git repository:

bash

git init

**Clone an existing repository:

bash

git clone git@github.com:username/repository.git

Set global username and email:

bash

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Check configuration:

bash

git config --list

2. SSH Key Setup (GitHub)

Generate SSH key:

bash

ssh-keygen -t ed25519 -C "you@example.com"

Check existing SSH keys:

bash

ls ~/.ssh

Copy public key to clipboard (Ubuntu):

bash

cat ~/.ssh/id_ed25519.pub

Add SSH key to GitHub via web UI. Test connection:

bash

ssh -T git@github.com

3. Basic Workflow (Add, Commit, Push)

Check status:

bash

git status

Add changes:

bash

git add file_name

Add all changes:

bash

git add .

Commit changes:

bash

git commit -m "Commit message"

Push to remote:

bash

git push origin main

Pull latest changes:

bash

git pull origin main

4. Branch Management

Create a new branch:

bash

git checkout -b branch_name

Switch branches:

bash

git checkout branch_name

Merge branch into current:

bash

git merge branch_name

Delete a branch locally:

bash

git branch -d branch_name

Delete a branch remotely:

bash

git push origin --delete branch_name

5. Stash Changes

Stash current changes:

bash

git stash

List stashes:

bash

git stash list

Apply stash:

bash

git stash apply

Drop a stash:

bash

git stash drop

6. Reset & Revert

Reset staged changes:

bash

git reset file_name

Reset to previous commit (soft):

bash

git reset --soft HEAD~1

Reset to previous commit (hard):

bash

git reset --hard HEAD~1

Revert a commit:

bash

git revert commit_hash

7. Logs & History

Show commit history:

bash

git log

Compact log:

bash

git log --oneline

Graphical log:

bash

git log --oneline --graph --all

Show changes for a file:

bash

git diff file_name

8. Submodules (Optional)

Add submodule:

bash

git submodule add git@github.com:username/repo.git path/to/submodule

Update submodules:

bash

git submodule update --init --recursive

9. Deployment Workflow (Practical)

Pull latest changes on server:

bash

cd /var/www/project
git fetch --all
git reset --hard origin/main

Check status:

bash

git status

Restart service after pull (FastAPI example):

bash

sudo systemctl restart fastapi_service

10. Common Issues & Fixes

Permission denied (SSH):

bash

ssh-add ~/.ssh/id_ed25519

Merge conflicts:

bash

# Resolve manually, then:
git add file_name
git commit -m "Resolved conflict"

Detached HEAD:

bash

git checkout main

PostgreSQL Management

1. Install PostgreSQL

Update packages:

bash

sudo apt update

Install PostgreSQL and contrib package:

bash

sudo apt install postgresql postgresql-contrib -y

Check PostgreSQL version:

bash

psql --version

Start PostgreSQL service:

bash

sudo systemctl start postgresql

Enable PostgreSQL on boot:

bash

sudo systemctl enable postgresql

Check service status:

bash

sudo systemctl status postgresql

Switch to postgres user:

bash

sudo -i -u postgres

Enter PostgreSQL shell:

bash

psql

Exit PostgreSQL shell:

bash

\q

3. Database Operations

List all databases:

bash

\l

Create a new database:

bash

CREATE DATABASE database_name;

Connect to a database:

bash

\c database_name

Drop a database:

bash

DROP DATABASE database_name;

4. User & Role Management

List all users:

bash

\du

Create a new user:

bash

CREATE USER username WITH PASSWORD 'password';

Grant privileges:

bash

GRANT ALL PRIVILEGES ON DATABASE database_name TO username;

Modify user:

bash

ALTER USER username WITH PASSWORD 'new_password';

Delete user:

bash

DROP USER username;

5. Table Operations

List tables in current database:

bash

\dt

Create table:

bash

CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50),
    email VARCHAR(100) UNIQUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Insert data:

bash

INSERT INTO users (name, email) VALUES ('Usama', 'usama@example.com');

Query data:

bash

SELECT * FROM users;

Update data*

bash

UPDATE users SET email='newemail@example.com' WHERE id=1;

Delete data:

bash

DELETE FROM users WHERE id=1;

Drop table:

bash

DROP TABLE users;

6. Query Monitoring

Show running queries

bash

SELECT pid, query, state, usename, client_addr FROM pg_stat_activity;

Terminate a query:

bash

SELECT pg_terminate_backend(PID);

Check database size:

bash

SELECT pg_size_pretty(pg_database_size('database_name'));

7. Backup & Restore

Backup database:

bash

pg_dump database_name > backup_file.sql

Backup with compression:

bash

pg_dump database_name | gzip > backup_file.sql.gz

Restore database:

bash

psql database_name < backup_file.sql

Restore compressed backup:

bash

gunzip -c backup_file.sql.gz | psql database_name

8. Remote Access

Edit PostgreSQL config:

bash

sudo nano /etc/postgresql/14/main/postgresql.conf
# Set listen_addresses = '*'

Allow remote connections in pg_hba.conf:

bash

sudo nano /etc/postgresql/14/main/pg_hba.conf
# Add: host all all 0.0.0.0/0 md5

Restart PostgreSQL:

bash

sudo systemctl restart postgresql

Test remote connection:

bash

psql -h server_ip -U username -d database_name

9. Performance Checking

Check indexes:

bash

\d table_name

Explain query plan:

bash

EXPLAIN ANALYZE SELECT * FROM table_name WHERE id=1;

Check active connections:

bash

SELECT count(*) FROM pg_stat_activity;

10. PostgreSQL Logs

Default log location:

bash

/var/log/postgresql/postgresql-14-main.log

Tail logs:

bash

tail -f /var/log/postgresql/postgresql-14-main.log

Search for errors:

bash

grep ERROR /var/log/postgresql/postgresql-14-main.log

FastAPI Server Management

1. Install Dependencies

Install Python and pip:

bash

sudo apt install python3 python3-pip -y

2. Virtual Environment

Create virtual environment:

bash

python3 -m venv venv

Activate virtual environment:

bash

source venv/bin/activate

Deactivate:

bash

deactivate

Install requirements from file:

bash

pip install -r requirements.txt

Freeze dependencies:

bash

pip freeze > requirements.txt

3. Run Development Server

Run FastAPI with Uvicorn:

bash

uvicorn main:app --reload --host 0.0.0.0 --port 8000

4. Production Server (Uvicorn / Gunicorn)

Run with Uvicorn workers:

bash

uvicorn main:app --host 0.0.0.0 --port 8000 --workers 4

Run with Gunicorn + Uvicorn workers:

bash

gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000

5. systemd Service Setup

Create service file:

bash

sudo nano /etc/systemd/system/fastapi.service

Example service file:

bash

[Unit]
Description=FastAPI Service
After=network.target
 
[Service]
User=youruser
Group=www-data
WorkingDirectory=/var/www/fastapi_app
ExecStart=/var/www/fastapi_app/venv/bin/uvicorn main:app --host 0.0.0.0 --port 8000
Restart=always
 
[Install]
WantedBy=multi-user.target

Reload systemd:

bash

sudo systemctl daemon-reload

Start service:

bash

sudo systemctl start fastapi

Enable on boot:

bash

sudo systemctl enable fastapi

Check status:

bash

sudo systemctl status fastapi

Restart service:

bash

sudo systemctl restart fastapi

6. Environment Variables

Example content:

bash

DATABASE_URL=postgresql://user:password@localhost/dbname
SECRET_KEY=your_secret_key
DEBUG=True

Load environment variables in Python:

bash

from dotenv import load_dotenv
import os
 
load_dotenv()
database_url = os.getenv("DATABASE_URL")

Reload after changes:

bash

source ~/.bashrc

7. Logs & Debugging

View systemd logs for FastAPI:

bash

journalctl -u fastapi.service -f

Check Uvicorn logs:

bash

tail -f /var/www/fastapi_app/uvicorn.log

8. CORS Issues

Enable CORS in FastAPI:

bash

from fastapi.middleware.cors import CORSMiddleware
 
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_methods=["*"],
    allow_headers=["*"],
)

9. Port Conflicts

Check processes using port 8000:

bash

sudo lsof -i :8000

Kill process:

bash

kill -9 PID

Restart Strategy

Restart manually:

bash

sudo systemctl restart fastapi

Restart after pull:

bash

git pull origin main
sudo systemctl restart fastapi

Reload on config change:

bash

sudo systemctl reload fastapi

Next.js Management

Install Dependencies

Update packages:

bash

sudo apt update
sudo apt upgrade -y

Install Node.js and npm:

bash

sudo apt install nodejs npm -y

Check versions:

bash

node -v
npm -v

Create New Project

Using create-next-app:

bash

npx create-next-app@latest my-nextjs-app

Navigate to project folder:

bash

cd my-nextjs-app

Install additional dependencies (optional):

bash

npm install axios dotenv

Run Development Server

Start dev server:

bash

npm run dev

Access locally:

code

http://localhost:3000

Custom port:

bash

PORT=4000 npm run dev

Build and Start Production Server

Build project:

bash

npm run build

Start production server:

bash

npm start

Custom host/port:

bash

HOST=0.0.0.0 PORT=5000 npm start

Environment Variables

Create .env.local file:

bash

nano .env.local

Example content:

NEXT_PUBLIC_API_URL=https://api.example.com
DATABASE_URL=postgresql://user:password@localhost/dbname

Access variables in code:

javascript

const apiUrl = process.env.NEXT_PUBLIC_API_URL;

Deployment with PM2

Install PM2 globally:

bash

npm install -g pm2

Start Next.js app with PM2:

bash

pm run build
pm run start &
pm2 start npm --name my-nextjs-app -- start

List PM2 processes:

bash

pm2 list

Restart app:

bash

pm2 restart my-nextjs-app

Stop app:

bash

pm2 stop my-nextjs-app

Save PM2 process list:

bash

pm2 save

Logs & Debugging

View PM2 logs:

bash

pm2 logs my-nextjs-app

Check error logs:

bash

pm2 logs my-nextjs-app --lines 100

Tail server logs manually:

bash

tail -f .next/server/logs/*.log

Common Issues & Fixes

Port already in use:

bash

sudo lsof -i :3000
kill -9 PID

Dependencies issues:

bash

rm -rf node_modules package-lock.json
npm install

Next.js build errors:

bash

npm run build --clean

PM2 Management

Install PM2

Install PM2 globally:

bash

npm install -g pm2

Check PM2 version:

bash

pm2 -v

Update PM2 to latest version:

bash

pm install pm2@latest -g

Start Application

Start a Node.js app:

bash

pm2 start app.js --name my-app

Start a Next.js app:

bash

pm run build
pm2 start npm --name my-nextjs-app -- start

Start with custom environment variables:

bash

pm2 start app.js --name my-app --env production

Start multiple apps:

bash

pm2 start app1.js --name app1
pm2 start app2.js --name app2

Manage Applications

List all PM2 processes:

bash

pm2 list

Stop an app:

bash

pm2 stop my-app

Restart an app:

bash

pm2 restart my-app

Delete an app from PM2:

bash

pm2 delete my-app

Reload app (zero downtime):

bash

pm2 reload my-app

Monitor Applications

Live monitoring:

bash

pm2 monit

Show app details:

bash

pm2 describe my-app

Check resource usage:

bash

pm2 list

Logs Management

View logs:

bash

pm2 logs my-app

Tail last N lines:

bash

pm2 logs my-app --lines 100

Clear logs:

bash

pm2 flush

Save logs to file manually:

bash

pm2 logs my-app > app.log

Auto Start on Reboot

Generate startup script:

bash

pm2 startup

Save current process list:

bash

pm2 save

Check startup script:

bash

pm2 list

Common Issues & Fixes

App not starting:

bash

pm2 logs my-app

Port conflicts:

bash

sudo lsof -i :PORT
kill -9 PID

Dependencies missing:

bash

rm -rf node_modules package-lock.json
npm install

PM2 not running on reboot:

bash

pm2 save
pm2 startup

Want To Stay Updated?

Table of Contents

VPS & System Management

1. Server Login & SSH

2. System Updates & Package Management

3. User Management

4. Service Management (systemctl)

5. Process Management

6. System Monitoring (CPU, RAM, Disk)

7. Firewall (UFW)

9. Cron Jobs

10. Time & Timezone

11. Reboot & Shutdown

Directory & File Management

1. Navigation

2. Listing Files

3. Creating Files & Folders

4. Copy, Move, Rename

5. Delete Operations

6. File Permissions

7. File Compression & Archiving

8. File Search

9. Viewing File Content

10. Disk Usage & Storage

Nginx Management

1. Install & Remove Nginx

2. Start, Stop, Restart

3. Configuration Files

4. Virtual Hosts / Server Blocks

5. Reverse Proxy Setup (FastAPI / Next.js)

6. Testing Configuration

7. Nginx Logs

8. Common Nginx Errors & Fixes

SSL Management

1. Install Certbot

2. Generate SSL Certificate

3. Auto Renewal

4. Test SSL

5. Remove / Revoke Certificate

6. Force HTTPS Redirect

7. Troubleshooting SSL

Git & GitHub Commands

1. Repository Setup

2. SSH Key Setup (GitHub)

3. Basic Workflow (Add, Commit, Push)

4. Branch Management

5. Stash Changes

6. Reset & Revert

7. Logs & History

8. Submodules (Optional)

9. Deployment Workflow (Practical)

10. Common Issues & Fixes

PostgreSQL Management

1. Install PostgreSQL

2. Login to psql

3. Database Operations

4. User & Role Management

5. Table Operations

6. Query Monitoring

7. Backup & Restore

8. Remote Access

9. Performance Checking

10. PostgreSQL Logs

FastAPI Server Management

1. Install Dependencies

2. Virtual Environment

3. Run Development Server

4. Production Server (Uvicorn / Gunicorn)

5. systemd Service Setup

6. Environment Variables

7. Logs & Debugging

8. CORS Issues

9. Port Conflicts

Restart Strategy

Next.js Management

Install Dependencies

Create New Project

Run Development Server

Build and Start Production Server

Environment Variables