vip-coordinator/STANDALONE_INSTALL.md

🚀 VIP Coordinator - Standalone Installation

Deploy VIP Coordinator directly from Docker Hub - No GitHub required!

📦 What You Get

• ✅ Pre-built Docker images from Docker Hub
• ✅ Interactive setup script that configures everything
• ✅ Complete deployment in under 5 minutes
• ✅ No source code needed - just Docker containers

🔧 Prerequisites

Ubuntu/Linux:

# Install Docker and Docker Compose
sudo apt update
sudo apt install docker.io docker-compose
sudo usermod -aG docker $USER
# Log out and back in, or run: newgrp docker

Other Systems:

• Install Docker Desktop from https://docker.com/get-started

🚀 Installation Methods

Method 1: Direct Download (Recommended)

# Create directory
mkdir vip-coordinator
cd vip-coordinator

# Download the standalone setup script
curl -O https://your-domain.com/standalone-setup.sh

# Make executable and run
chmod +x standalone-setup.sh
./standalone-setup.sh

Method 2: Copy-Paste Installation

If you can't download the script, you can create it manually:

# Create directory
mkdir vip-coordinator
cd vip-coordinator

# Create the setup script (copy the content from standalone-setup.sh)
nano standalone-setup.sh

# Make executable and run
chmod +x standalone-setup.sh
./standalone-setup.sh

Method 3: Manual Docker Hub Deployment

If you prefer to set up manually:

# Create directory
mkdir vip-coordinator
cd vip-coordinator

# Create docker-compose.yml
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  db:
    image: postgres:15
    environment:
      POSTGRES_DB: vip_coordinator
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 30s
      timeout: 10s
      retries: 3

  redis:
    image: redis:7
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 30s
      timeout: 10s
      retries: 3

  backend:
    image: t72chevy/vip-coordinator:backend-latest
    environment:
      DATABASE_URL: postgresql://postgres:${DB_PASSWORD}@db:5432/vip_coordinator
      REDIS_URL: redis://redis:6379
      GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID}
      GOOGLE_CLIENT_SECRET: ${GOOGLE_CLIENT_SECRET}
      GOOGLE_REDIRECT_URI: ${GOOGLE_REDIRECT_URI}
      FRONTEND_URL: ${FRONTEND_URL}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
      PORT: 3000
    ports:
      - "3000:3000"
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  frontend:
    image: t72chevy/vip-coordinator:frontend-latest
    ports:
      - "80:80"
    depends_on:
      - backend
    restart: unless-stopped

volumes:
  postgres-data:
EOF

# Create .env file with your configuration
nano .env

# Start the application
docker-compose pull
docker-compose up -d

🎯 What the Setup Script Does

1. Checks Prerequisites: Verifies Docker and Docker Compose are installed
2. Interactive Configuration: Asks for your deployment preferences
3. Generates Files: Creates all necessary configuration files
4. Pulls Images: Downloads pre-built images from Docker Hub
5. Creates Management Scripts: Provides easy start/stop/update commands

📋 Configuration Options

The script will ask you for:

• Deployment Type: Local development or production
• Domain Settings: Your domain names (for production)
• Security: Generates secure passwords automatically
• Google OAuth: Your Google Cloud Console credentials
• Optional: AviationStack API key for flight data

🔐 Google OAuth Setup

You'll need to set up Google OAuth (the script guides you through this):

1. Go to Google Cloud Console
2. Create a new project
3. Enable Google+ API
4. Create OAuth 2.0 Client ID
5. Add redirect URI (provided by the script)
6. Copy Client ID and Secret

📦 Docker Hub Images Used

This deployment uses these pre-built images:

• t72chevy/vip-coordinator:backend-latest (404MB)

  • Complete Node.js backend with OAuth fixes
  • PostgreSQL and Redis integration
  • Health checks and monitoring

• t72chevy/vip-coordinator:frontend-latest (74.8MB)

  • React frontend with mobile OAuth fixes
  • Nginx web server
  • Production-optimized build

• postgres:15 - Database

• redis:7 - Cache and sessions

🚀 After Installation

Once setup completes, you'll have these commands:

./start.sh    # Start VIP Coordinator
./stop.sh     # Stop VIP Coordinator
./update.sh   # Update to latest Docker Hub images
./status.sh   # Check system status
./logs.sh     # View application logs

🌐 Access Your Application

• Local: http://localhost
• Production: https://your-domain.com

🔄 Updates

To update to the latest version:

./update.sh

This pulls the latest images from Docker Hub and restarts the services.

📱 Mobile Support

This deployment includes fixes for mobile OAuth authentication:

• ✅ Mobile users can now log in successfully
• ✅ Proper API endpoint configuration
• ✅ Enhanced error handling

🛠️ Troubleshooting

Common Issues

Docker permission denied:

sudo usermod -aG docker $USER
newgrp docker

Port conflicts:

# Check what's using ports 80 and 3000
sudo netstat -tulpn | grep :80
sudo netstat -tulpn | grep :3000

Service not starting:

./status.sh  # Check status
./logs.sh    # View logs

📞 Distribution

To share VIP Coordinator with others:

1. Share the setup script: Give them standalone-setup.sh
2. Share this guide: Include STANDALONE_INSTALL.md
3. No GitHub needed: Everything pulls from Docker Hub

🎉 Benefits of Standalone Deployment

• ✅ No source code required
• ✅ No GitHub repository needed
• ✅ Pre-built, tested images
• ✅ Automatic updates from Docker Hub
• ✅ Cross-platform compatibility
• ✅ Production-ready configuration

---

🚀 Get VIP Coordinator running in under 5 minutes with just Docker and one script!