VPS Setup Skill

This skill helps set up a fresh Ubuntu VPS as a secure web development playground. It includes automated scripts and step-by-step guides for installing Node.js, Python, Nginx, PM2, Docker, SSL certificates, and security tools.

When to Use This Skill

• •Setting up a fresh VPS or cloud server
• •Configuring a development/staging environment
• •Helping users deploy their first web application
• •Setting up reverse proxy with Nginx
• •Configuring SSL certificates with Let's Encrypt
• •Hardening server security

Quick Start

For a complete automated setup, use the setup script:

# Download and run the setup script
curl -fsSL https://raw.githubusercontent.com/your-repo/vps-setup.sh | bash

Or guide users through the manual process using the reference documentation.

Architecture Overview

Internet → UFW Firewall → Nginx (80/443) → PM2 Apps (3000+)
                        ↘ Direct port access (3000-3010)

Core Components

Default Port Assignments

Instructions for Claude

When helping a user set up a VPS:

1. Assess the Starting Point

# Check OS version
cat /etc/os-release

# Check what's already installed
which node npm python3 nginx docker pm2

# Check disk space and memory
df -h && free -h

2. Run Core Installation

Either use the automated script or guide through manual steps:

• •Update system packages
• •Install Node.js via NodeSource
• •Install PM2 globally
• •Install and configure Nginx
• •Set up UFW firewall
• •Install and configure fail2ban
• •Install Certbot for SSL

3. Create Project Structure

mkdir -p /home/projects
cd /home/projects

4. Deploy First Test App

# Create hello-world test
mkdir hello-world && cd hello-world
npm init -y
# Create simple Express server
pm2 start server.js --name hello-world

5. Configure Nginx Reverse Proxy

• •Create site config in /etc/nginx/sites-available/
• •Enable with symlink to sites-enabled/
• •Test and reload nginx

6. Set Up SSL (if domain available)

certbot --nginx -d yourdomain.com

7. Create Documentation

Generate CLAUDE.md, README.md, and QUICKSTART.md in /home/projects/

Key Commands Reference

PM2 Management

pm2 list                    # View all apps
pm2 logs [app]             # View logs
pm2 restart [app]          # Restart app
pm2 stop [app]             # Stop app
pm2 delete [app]           # Remove app
pm2 save                   # Save current apps
pm2 startup                # Enable auto-start on boot

Nginx Management

nginx -t                   # Test config
systemctl reload nginx     # Apply changes
systemctl status nginx     # Check status

Firewall Management

ufw status                 # View rules
ufw allow [port]/tcp       # Open port
ufw delete allow [port]    # Close port

SSL Certificate Management

certbot certificates       # List certs
certbot renew --dry-run   # Test renewal
certbot --nginx -d domain  # Add new cert

Security Checklist

• • UFW firewall enabled with minimal ports
• • fail2ban protecting SSH
• • SSH key authentication (recommended)
• • Regular system updates configured
• • SSL certificates installed
• • Non-root user for daily use (optional)

Troubleshooting

App not accessible

1. •Check if running: pm2 list
2. •Check logs: pm2 logs [app]
3. •Check port: lsof -i :[port]
4. •Check firewall: ufw status

SSL certificate issues

1. •Check cert status: certbot certificates
2. •Test renewal: certbot renew --dry-run
3. •Check nginx config: nginx -t

Out of memory

1. •Check usage: free -h
2. •Check processes: htop or top
3. •Consider adding swap space

Files in This Skill

• •scripts/setup.sh - Automated installation script
• •scripts/add-site.sh - Add new site helper
• •templates/nginx-site.conf - Nginx site template
• •templates/CLAUDE.md - AI assistant guide template
• •templates/README.md - Project README template
• •reference.md - Detailed step-by-step guide