iDefineHD/TurboTrades

Fork 0

Files

iDefineHD 53d0c89d17

Deploy to Production Server / Deploy to 178.63.127.19 (push) Has been cancelled

Details

Clean up tunnel infrastructure and migrate to Gitea

2026-01-10 23:54:31 +00:00

16 KiB

Raw Permalink Blame History

TurboTrades Deployment Guide

Complete guide to deploy TurboTrades to your production server at 178.63.127.19

🔧 Prerequisites

On Your Local Machine:

Git installed
GitHub account with repository access
SSH access to server (178.63.127.19)

On Your Server (178.63.127.19):

Ubuntu/Debian Linux
Node.js 18+ installed
MongoDB installed and running
PM2 process manager
Nginx (optional, for reverse proxy)
Git installed

🖥️ Server Setup

Step 1: SSH into Your Server

ssh root@178.63.127.19
# Or with specific user:
ssh yourusername@178.63.127.19

Step 2: Install Required Software

# Update system
sudo apt update && sudo apt upgrade -y

# Install Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install MongoDB
wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu $(lsb_release -cs)/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
sudo apt update
sudo apt install -y mongodb-org

# Start MongoDB
sudo systemctl start mongod
sudo systemctl enable mongod

# Install PM2 globally
sudo npm install -g pm2

# Install Git
sudo apt install -y git

# Install Nginx (optional)
sudo apt install -y nginx

Step 3: Create Deployment Directory

# Create directory
sudo mkdir -p /var/www/turbotrades
sudo chown -R $USER:$USER /var/www/turbotrades

# Navigate to directory
cd /var/www/turbotrades

Step 4: Generate SSH Deploy Key (Optional but Recommended)

# Generate SSH key for deployment
ssh-keygen -t ed25519 -C "deploy@turbotrades" -f ~/.ssh/turbotrades_deploy_key

# Display public key (add to GitHub Deploy Keys)
cat ~/.ssh/turbotrades_deploy_key.pub

# Display private key (add to GitHub Secrets)
cat ~/.ssh/turbotrades_deploy_key

Step 5: Clone Repository

cd /var/www/turbotrades
git clone https://git.turbotrades.dev/iDefineHD/TurboTrades.git .

# Or with SSH key:
git clone git@git.turbotrades.dev:iDefineHD/TurboTrades.git .

Step 6: Create Environment File

cd /var/www/turbotrades
nano .env

Add the following configuration:

# Server Configuration
NODE_ENV=production
PORT=3000
HOST=0.0.0.0

# Database
MONGODB_URI=mongodb://localhost:27017/turbotrades

# Session Secret (Generate a secure random string)
SESSION_SECRET=your-super-secret-session-key-change-this

# Steam API
STEAM_API_KEY=your-steam-api-key-here
STEAM_RETURN_URL=http://178.63.127.19:3000/auth/steam/return

# JWT Secret (Generate a secure random string)
JWT_SECRET=your-super-secret-jwt-key-change-this
JWT_ACCESS_EXPIRY=15m
JWT_REFRESH_EXPIRY=7d

# CORS
CORS_ORIGIN=http://178.63.127.19

# Redis (if using)
REDIS_URL=redis://localhost:6379

# Admin Steam IDs (comma-separated)
ADMIN_STEAM_IDS=76561198000000000,76561198111111111

# Bot Configuration
STEAM_BOT_USERNAME=your-bot-username
STEAM_BOT_PASSWORD=your-bot-password
STEAM_BOT_SHARED_SECRET=your-bot-shared-secret
STEAM_BOT_IDENTITY_SECRET=your-bot-identity-secret

# CSGOFloat API (optional)
CSGOFLOAT_API_KEY=your-csgofloat-api-key

# Pricing API (optional)
PRICING_API_KEY=your-pricing-api-key

Save and exit (Ctrl+X, Y, Enter)

Step 7: Install Dependencies

# Backend dependencies
npm ci --production

# Frontend dependencies and build
cd frontend
npm ci
npm run build
cd ..

Step 8: Setup PM2

# Start application with PM2
pm2 start ecosystem.config.js --env production

# Save PM2 configuration
pm2 save

# Setup PM2 to start on boot
pm2 startup
# Follow the instructions provided by the command above

# Check status
pm2 status
pm2 logs turbotrades

Step 9: Configure Nginx (Optional but Recommended)

sudo nano /etc/nginx/sites-available/turbotrades

Add the following configuration:

server {
    listen 80;
    server_name 178.63.127.19 yourdomain.com;

    # Frontend (Vite build)
    location / {
        root /var/www/turbotrades/frontend/dist;
        try_files $uri $uri/ /index.html;
        
        # Cache static assets
        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
            expires 1y;
            add_header Cache-Control "public, immutable";
        }
    }

    # Backend API
    location /api {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }

    # WebSocket support
    location /ws {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    # Auth routes
    location /auth {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Enable the site:

sudo ln -s /etc/nginx/sites-available/turbotrades /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Step 10: Configure Firewall

# Allow SSH, HTTP, and HTTPS
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

🔐 GitHub Secrets Configuration

Step 1: Go to GitHub Repository Settings

Go to your repository: https://git.turbotrades.dev/iDefineHD/TurboTrades
Click Settings → Secrets (or CI/CD settings depending on Gitea version)
Click New repository secret

Step 2: Add Required Secrets

Add each of these secrets:

`SERVER_HOST`

178.63.127.19

`SERVER_USER`

root

(or your SSH username)

`SERVER_PORT`

`SSH_PRIVATE_KEY`

-----BEGIN OPENSSH PRIVATE KEY-----
[Your private key content from ~/.ssh/turbotrades_deploy_key]
-----END OPENSSH PRIVATE KEY-----

`DEPLOY_PATH`

/var/www/turbotrades

Step 3: Add Deploy Key to GitHub (If Using SSH)

Go to Settings → Deploy keys
Click Add deploy key
Title: Production Server 178.63.127.19
Key: Paste your public key from ~/.ssh/turbotrades_deploy_key.pub
✅ Check Allow write access (if needed)
Click Add key

🚀 Initial Deployment

Method 1: Manual Initial Setup (Recommended)

Already completed in Server Setup above!

Method 2: Using PM2 Deploy

# From your local machine
pm2 deploy ecosystem.config.js production setup
pm2 deploy ecosystem.config.js production

🔄 Automatic Deployments

How It Works

The CI/CD workflow (.github/workflows/deploy.yml) automatically deploys when:

You push to the main branch
You manually trigger the workflow

Deployment Process

Trigger: Push to main branch

git add .
git commit -m "feat: Add new feature"
git push origin main

CI/CD Pipeline: Automatically runs
- ✅ Checks out code
- ✅ Builds frontend
- ✅ Runs tests
- ✅ Deploys to server via SSH
- ✅ Restarts PM2
- ✅ Runs health check
- ✅ Rolls back if failed
Monitor: Check repository Actions tab for progress

Manual Trigger

Go to Actions tab on GitHub
Select Deploy to Production Server
Click Run workflow
Select branch (usually main)
Click Run workflow

🛠️ Manual Deployment

Quick Deploy (SSH to Server)

# SSH into server
ssh root@178.63.127.19

# Navigate to project
cd /var/www/turbotrades

# Pull latest changes
git pull origin main

# Install dependencies
npm ci --production
cd frontend && npm ci && npm run build && cd ..

# Restart application
pm2 restart turbotrades

# Check status
pm2 status
pm2 logs turbotrades --lines 50

Using PM2 Deploy Command

# From your local machine
pm2 deploy ecosystem.config.js production update

📊 Monitoring & Maintenance

Check Application Status

# SSH into server
ssh root@178.63.127.19

# Check PM2 status
pm2 status

# View logs
pm2 logs turbotrades

# View last 100 lines
pm2 logs turbotrades --lines 100

# View only errors
pm2 logs turbotrades --err

# Monitor in real-time
pm2 monit

Check Server Resources

# CPU and Memory usage
htop

# Disk usage
df -h

# Check MongoDB status
sudo systemctl status mongod

# Check Nginx status
sudo systemctl status nginx

Database Backup

# Create backup directory
mkdir -p /var/backups/turbotrades

# Backup MongoDB
mongodump --out /var/backups/turbotrades/backup-$(date +%Y%m%d-%H%M%S)

# Automated daily backup (add to crontab)
crontab -e
# Add this line:
0 2 * * * mongodump --out /var/backups/turbotrades/backup-$(date +\%Y\%m\%d)

View Application Logs

# PM2 logs
pm2 logs turbotrades

# Application logs (if file-based)
tail -f /var/www/turbotrades/logs/app.log

# Nginx access logs
tail -f /var/log/nginx/access.log

# Nginx error logs
tail -f /var/log/nginx/error.log

Restart Services

# Restart application
pm2 restart turbotrades

# Restart all PM2 apps
pm2 restart all

# Restart MongoDB
sudo systemctl restart mongod

# Restart Nginx
sudo systemctl restart nginx

# Reload Nginx (without downtime)
sudo systemctl reload nginx

🐛 Troubleshooting

Issue: Application Won't Start

# Check PM2 logs
pm2 logs turbotrades --err

# Check if port is already in use
sudo lsof -i :3000

# Check environment variables
pm2 show turbotrades

# Restart with fresh environment
pm2 delete turbotrades
pm2 start ecosystem.config.js --env production

Issue: Cannot Connect to Database

# Check MongoDB status
sudo systemctl status mongod

# Start MongoDB
sudo systemctl start mongod

# Check MongoDB logs
sudo tail -f /var/log/mongodb/mongod.log

# Test MongoDB connection
mongosh

Issue: "Permission Denied" Errors

# Fix ownership
sudo chown -R $USER:$USER /var/www/turbotrades

# Fix permissions
chmod -R 755 /var/www/turbotrades

Issue: CI/CD Deployment Fails

Check CI/CD logs
- Go to repository Actions tab
- Click on failed workflow
- Review error messages
Verify Secrets
- Settings → Secrets and variables → Actions
- Ensure all secrets are set correctly
Test SSH Connection Manually
```
ssh root@178.63.127.19
```

Check Deployment Path

ssh root@178.63.127.19 "ls -la /var/www/turbotrades"

Issue: 502 Bad Gateway (Nginx)

# Check if app is running
pm2 status

# Restart application
pm2 restart turbotrades

# Check Nginx configuration
sudo nginx -t

# View Nginx error logs
sudo tail -f /var/log/nginx/error.log

Issue: Out of Memory

# Check memory usage
free -h

# Increase PM2 memory limit
pm2 stop turbotrades
# Edit ecosystem.config.js and increase max_memory_restart
pm2 start ecosystem.config.js

# Add swap space (if needed)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

⏮️ Rollback Procedures

Automatic Rollback

The CI/CD workflow automatically rolls back if deployment fails.

Manual Rollback

Method 1: Using Backups

# SSH into server
ssh root@178.63.127.19

# List backups
ls -lt /var/www/ | grep turbotrades-backup

# Restore from backup
cd /var/www
rm -rf turbotrades/*
cp -r turbotrades-backup-YYYYMMDD-HHMMSS/* turbotrades/

# Restart application
cd turbotrades
pm2 restart turbotrades

Method 2: Using Git

# SSH into server
ssh root@178.63.127.19
cd /var/www/turbotrades

# View commit history
git log --oneline

# Rollback to specific commit
git reset --hard COMMIT_HASH

# Reinstall dependencies
npm ci --production
cd frontend && npm ci && npm run build && cd ..

# Restart
pm2 restart turbotrades

Method 3: Rollback to Previous Tag

# SSH into server
cd /var/www/turbotrades

# List tags
git tag -l

# Checkout specific tag
git checkout v1.0.0

# Rebuild and restart
npm ci --production
cd frontend && npm ci && npm run build && cd ..
pm2 restart turbotrades

📝 Deployment Checklist

Before Deployment

All tests pass locally
Environment variables configured
Database migrations ready (if any)
Backup current production data
Notify team about deployment

During Deployment

Monitor CI/CD workflow
Watch server logs
Check PM2 status
Verify health endpoint

After Deployment

Test critical features
Check error logs
Verify database connectivity
Test admin panel
Test user authentication
Monitor performance metrics

🔒 Security Best Practices

Keep Secrets Safe
- Never commit .env file
- Use GitHub Secrets for sensitive data
- Rotate secrets regularly

Keep Software Updated

sudo apt update && sudo apt upgrade
npm update

Enable Firewall
```
sudo ufw enable
sudo ufw status
```

Use HTTPS (Recommended)

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com

Regular Backups
- Database backups daily
- Code backups before deployment
- Test restore procedures

📞 Support & Resources

Useful Commands

# Full deployment script
cd /var/www/turbotrades && \
git pull origin main && \
npm ci --production && \
cd frontend && npm ci && npm run build && cd .. && \
pm2 restart turbotrades && \
pm2 logs turbotrades --lines 20

# Quick restart
pm2 restart turbotrades && pm2 logs turbotrades

# Check everything
pm2 status && \
sudo systemctl status mongod && \
sudo systemctl status nginx

Logs Locations

PM2 Logs: ~/.pm2/logs/
Application Logs: /var/www/turbotrades/logs/
Nginx Access: /var/log/nginx/access.log
Nginx Error: /var/log/nginx/error.log
MongoDB: /var/log/mongodb/mongod.log

Performance Monitoring

# Install monitoring tools
sudo npm install -g pm2-logrotate
pm2 install pm2-logrotate

# Monitor resources
pm2 monit
htop

🎯 Quick Reference

Deploy from Local Machine

git add .
git commit -m "Your message"
git push origin main
# CI/CD pipeline handles the rest!

Manual Deploy on Server

ssh root@178.63.127.19
cd /var/www/turbotrades
git pull && npm ci --production && cd frontend && npm ci && npm run build && cd .. && pm2 restart turbotrades

Check Status

ssh root@178.63.127.19 "pm2 status && pm2 logs turbotrades --lines 20"

Emergency Restart

ssh root@178.63.127.19 "pm2 restart turbotrades"

🎉 Your deployment is now automated and production-ready!

For issues or questions, check the troubleshooting section or review the logs.

16 KiB Raw Permalink Blame History