net/TROUBLESHOOTING.md

Spark Platform - Troubleshooting & SSH Access

Server Access

SSH Connection

ssh root@72.61.15.216
# Password required (obtain from server admin)

Coolify API Access

# API Token
COOLIFY_TOKEN="4|tqkE6hP6cnYzJtFF4XxIYQ3LXDUyd1gnUKq7sCnv66b39b0d"

# Application UUID
APP_UUID="i8cswkos04c4s08404ok0ws4"

# Get application info
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "http://72.61.15.216:8000/api/v1/applications/$APP_UUID"

# Get logs
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "http://72.61.15.216:8000/api/v1/applications/$APP_UUID/logs"

# Trigger deployment
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -X POST "http://72.61.15.216:8000/api/v1/deploy?uuid=$APP_UUID"

---

Docker Commands (via SSH)

View Running Containers

docker ps
docker ps | grep -E 'directus|frontend|postgresql'

View Container Logs

# Frontend logs
docker logs <frontend-container-id> --tail 100

# Directus logs
docker logs <directus-container-id> --tail 100

# Follow logs in real-time
docker logs -f <container-id>

Check Container Status

# Inspect container
docker inspect <container-id>

# Check health
docker inspect <container-id> | grep -A 10 Health

Restart Services

# Restart specific service
docker restart <container-id>

# Restart all services
docker restart $(docker ps -q)

---

Troubleshooting Failed Deployments

Check Deployment Logs in Coolify

1. Go to http://72.61.15.216:8000
2. Navigate to Application → Deployments
3. Click failed deployment
4. View "Logs" tab
5. Look for error messages at the bottom

Common Issues

CORS Errors

Symptom: Frontend loads but Intelligence pages show "Failed to fetch"

Fix:

1. Check docker-compose.yaml has CORS vars
2. Verify Directus container has environment variables
3. Restart Directus service

# Check Directus environment
docker exec <directus-container> env | grep CORS

# Should see:
# CORS_ENABLED=true
# CORS_ORIGIN=https://launch.jumpstartscaling.com

Port Conflicts

Symptom: Deployment fails with "port already allocated"

Fix:

# Find what's using the port
lsof -i :4321
lsof -i :8055

# Kill process or change port in config

Build Failures

Symptom: Deployment fails during build step

Common causes:

• Missing dependencies
• TypeScript errors
• Out of memory

Fix:

# Check Docker build logs
docker logs <coolify-builder-container>

# Increase Docker memory limit if needed

Database Connection Issues

Symptom: Directus can't connect to PostgreSQL

Fix:

# Check PostgreSQL is running
docker ps | grep postgres

# Check Directus can reach it
docker exec <directus-container> ping postgresql

# Verify credentials in environment
docker exec <directus-container> env | grep DB_

---

Service URLs

Production

• Frontend (Launch): https://launch.jumpstartscaling.com
• Directus (Spark): https://spark.jumpstartscaling.com
• Coolify: http://72.61.15.216:8000

Health Checks

# Frontend health
curl -I https://launch.jumpstartscaling.com

# Directus health  
curl -I https://spark.jumpstartscaling.com/admin/login

# Check if services respond
curl -I https://launch.jumpstartscaling.com/admin
curl -I https://spark.jumpstartscaling.com/items/sites

---

Quick Diagnostics

Full System Check

#!/bin/bash
echo "=== Docker Containers ==="
docker ps

echo -e "\n=== Frontend Status ==="
curl -sI https://launch.jumpstartscaling.com | head -5

echo -e "\n=== Directus Status ==="
curl -sI https://spark.jumpstartscaling.com | head -5

echo -e "\n=== Database Status ==="
docker exec <postgres-container> pg_isready

echo -e "\n=== Recent Logs ==="
docker logs <frontend-container> --tail 20
docker logs <directus-container> --tail 20

Check Environment Variables

# Directus environment
docker exec <directus-container> env | grep -E "CORS|DB_|ADMIN"

# Frontend environment  
docker exec <frontend-container> env | grep -E "DIRECTUS|PUBLIC"

---

Deployment Workflow

Manual Deployment via Coolify

1. Commit changes to Git
2. Push to GitHub main branch
3. Coolify webhook triggers or manual deploy
4. Coolify pulls latest code
5. Runs docker-compose build
6. Starts new containers
7. Routes traffic via Traefik

Verify Deployment

# Check latest commit deployed
curl https://launch.jumpstartscaling.com | grep -o 'version.*' | head -1

# Check build time
docker inspect <container> | grep Created

---

Emergency Procedures

Rollback Deployment

1. In Coolify, find previous successful deployment
2. Click "Redeploy" on that deployment
3. Wait for build to complete

Force Rebuild

# SSH into server
ssh root@72.61.15.216

# Force remove containers
docker-compose down

# Rebuild from scratch
docker-compose up -d --build

# Or via Coolify:
# Click "Redeploy" with "Force Rebuild" option

Database Backup

# Backup PostgreSQL
docker exec <postgres-container> pg_dump -U directus directus > backup.sql

# Restore
docker exec -i <postgres-container> psql -U directus directus < backup.sql

---

Monitoring

Real-Time Logs

# Follow all logs
docker-compose logs -f

# Follow specific service
docker-compose logs -f frontend
docker-compose logs -f directus

Resource Usage

# Container resources
docker stats

# Disk space
df -h
docker system df

---

Contact & Access

Server: 72. 61.15.216
Coolify Web: http://72.61.15.216:8000
SSH User: root
Coolify Token: 4|tqkE6hP6cnYzJtFF4XxIYQ3LXDUyd1gnUKq7sCnv66b39b0d
App UUID: i8cswkos04c4s08404ok0ws4